@ihabdevteam/core 0.414.0 → 0.416.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 (33) hide show
  1. package/CHANGELOG.md +360 -0
  2. package/dist/components.cjs.js +40 -40
  3. package/dist/components.esm.css +2 -2
  4. package/dist/hooks.cjs.js +3 -3
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core.cjs.js +181 -181
  7. package/dist/ihabdevteam-core.d.ts +33 -3
  8. package/dist/packages/core/src/components/BarChart.css +41 -13
  9. package/dist/packages/core/src/components/BarChart.d.ts +1 -1
  10. package/dist/packages/core/src/components/BarChart.js +52 -15
  11. package/dist/packages/core/src/components/ChartSection.css +149 -37
  12. package/dist/packages/core/src/components/ChartSection.d.ts +23 -1
  13. package/dist/packages/core/src/components/ChartSection.js +48 -7
  14. package/dist/packages/core/src/components/Header.css +3 -1
  15. package/dist/packages/core/src/components/RingChart.js +2 -2
  16. package/dist/packages/core/src/components/SideNav.css +44 -15
  17. package/dist/packages/core/src/components/SideNav.js +1 -1
  18. package/dist/packages/core/src/components/Word/WordSearchResultBlock.css +9 -0
  19. package/dist/packages/core/src/components/Word/WordSearchResultBlock.js +6 -1
  20. package/dist/packages/core/src/components/barChartData.d.ts +23 -0
  21. package/dist/packages/core/src/components/barChartData.js +30 -0
  22. package/dist/packages/core/src/components/barChartTypes.d.ts +8 -0
  23. package/dist/packages/core/src/components/useBarChartControl.js +17 -13
  24. package/dist/packages/core/src/hooks/useWideCardSpans.d.ts +28 -0
  25. package/dist/packages/core/src/hooks/useWideCardSpans.js +85 -0
  26. package/dist/packages/core/src/i18n/locales/en.json +2 -1
  27. package/dist/packages/core/src/i18n/locales/ko.json +1 -0
  28. package/dist/packages/core/src/utils/date.d.ts +12 -0
  29. package/dist/packages/core/src/utils/date.js +18 -0
  30. package/dist/packages/core/src/version.d.ts +1 -1
  31. package/dist/packages/core/src/version.js +1 -1
  32. package/dist/utils.cjs.js +3 -3
  33. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -7,6 +7,366 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.416.0 — **기간 고르개 이름표가 끝까지 보인다** · 영어는 짧은 꼴로 (청 (365))
11
+
12
+ 차트 카드 머리의 기간 고르개가 상자를 **150px 에 못으로 박고** 있어서 긴 이름표가 끊겼다.
13
+ 말귀_2 가 올린 청이고, **세 가지가 함께** 들어간다 — ① 상자를 글에 맞춰 늘리고,
14
+ ② 영어 달 이름을 줄이고(`September` → `Sep`), ③ 고르개의 영어 주 이름표를 줄인다
15
+ (`Week 4` → `W4`). 하나만으로는 안 된다 — 아래에 왜인지 적는다.
16
+
17
+ ### 무엇이 끊겼나 (실측 2026-11-03 · 카드 540 · 글자 16px)
18
+
19
+ 상자 150 의 이름표 칸은 **100px** 이다(150 − 좌우 여백 24 − 화살표 16 − 사이 8 − 테두리 2).
20
+ 그 칸은 `overflow: hidden` + `ellipsis` 라 넘치는 만큼 조용히 사라진다. 이름표 120개를
21
+ **살아 있는 상자에 꽂아** 양쪽으로 쟀다:
22
+
23
+ | 말 | 가장 긴 이름표 | 가장 짧은 것 | 100 을 넘는 것 |
24
+ |---|---|---|---|
25
+ | 한국어 `첫째`~`넷째주` | `2026.10 넷째주` **102.4** | 92.8 | **8 / 48** |
26
+ | 한국어 **`다섯째주`** | `2026.10 다섯째주` **116.2** | 106.6 | **12 / 12** |
27
+ | 영어 | `September 2026 Week 4` **179.2** | 126.0 | **60 / 60** |
28
+
29
+ 예순 가운데 **스물이** 끊겼다. `다섯째주` 는 **열두 달 전부**, 나머지 네 꼴은 두 자리 달에서만
30
+ (`2026.10`·`2026.12` — `2026.11` 은 `1` 이 좁아 99.8 로 간신히 들어온다). **영어는 예순이
31
+ 전부** 끊겼고, 끊기는 자리가 나빠서 `November 2026 Week 1` 이 `November …` 로 보였다 —
32
+ **주 수가 통째로 사라진다**(스무 자 중 열한 자).
33
+
34
+ 위 예순은 **열두 달 × 다섯 주를 다 세운 것**이다 — 상자가 살아남아야 하는 범위다. **지금
35
+ 화면에서 고를 수 있는 것**은 자료가 있는 달뿐이라 더 좁다: 말귀_2 가 고르개를 열어 선
36
+ 마흔 개의 글을 그대로 읽어 **마흔 중 여덟**을 쟀다(제일 큰 것 `2026.11 다섯째주` 113.7 ·
37
+ 제일 작은 것 `2026.7 첫째주` 95.8). **두 수가 다 참이다** — 여덟은 오늘 사람이 겪는 수,
38
+ 스물은 달이 바뀌어도 안 깨지려면 담아야 하는 수.
39
+
40
+ > **자를 맞댄 기록** — 처음에 적은 표는 *"`첫째`~`넷째주` 는 최대 96 으로 0/48"* 이었는데
41
+ > **틀렸다.** 접힌 통(카드 36px)에서 먼저 재어 글꼴이 **15px** 로 잡힌 것을 1440 수치인 양
42
+ > 옮겨 적었다. 말귀_2 가 *"그 수는 제 자로 안 나온다"* 고 맞대 와서 다시 쟀다 —
43
+ > **세 자(살아 있는 이름표의 Range · 떼어 낸 쌍둥이 · canvas `measureText`)가 한 수에
44
+ > 모였다**(400 16px/26px Pretendard, letter-spacing normal). 위 표가 그 수다.
45
+ >
46
+ > 말귀_2 쪽 첫 수가 조금 더 넓었던 까닭도 **찾았다** — 그쪽이 이름표 글을 지어내며 달을
47
+ > 두 자리로 채웠다(`2026.01`). 코어는 `month` 를 **맨 수로** 넘기니 `2026.6` 으로 선다.
48
+ > 글을 고쳐 다시 재니 **`2026.10 넷째주` 102.4 가 소수점까지 같았다.** 남은 차이는 범위뿐
49
+ > 이다(그쪽 보기에 `2026.12` 가 없어 `다섯째주` 최대가 113.7).
50
+ >
51
+ > **배운 것** — 이름표 수를 재려면 글을 **지어내지 말고 고르개를 열어 그대로 읽는다.**
52
+ > 재는 자리도 함께 적는다: **놀이터 · 1440 · 카드 540 · 이름표 칸 100 · 400 16px/26px.**
53
+
54
+ ### 고친 자리 ① 상자 — **바닥만 남기고 글에 맞춰 늘린다**
55
+
56
+ ```css
57
+ .month-dropdown .dropdown__trigger { width: auto; min-width: 150px; max-width: none }
58
+ ```
59
+
60
+ **수를 올리는 것으로는 안 됐다.** 150 → 160 은 이름표 칸이 110 이라 여전히 모자라고(116
61
+ 필요), 166 으로 딱 맞추면 다음에 글이 한 자 늘 때 또 끊긴다. 그래서 **고치는 자리가 수가
62
+ 아니라 못이다.** 사장님이 고르신 150(2026-11-02 *"길이도 좀 줄이고"*)은 **짧은 글에서 줄이
63
+ 흔들리지 않게 지키는 바닥**으로 남고, 넘칠 때만 그만큼 넓어진다.
64
+
65
+ 그 자리에 적혀 있던 까닭 — *"가장 긴 글(`2026.11 다섯째주`)을 담는 만큼"* — 은 **틀린
66
+ 말이었다.** 150 은 그 글을 담지 못한다(100 < 116). 수를 고른 날 재지 않고 적은 글이다.
67
+
68
+ **카드는 안 커진다**(실측, 속 폭 500): 늘어난 몫은 **제목 칸이 내준다.**
69
+
70
+ | 선 이름표 | 상자 | 조절칸 | 제목 | 머리 |
71
+ |---|---|---|---|---|
72
+ | `2026.11 첫째주` | 150 | 366 | 126 | 한 줄 (32) |
73
+ | `2026.10 다섯째주` | 166 | 382 | 110 | 한 줄 (32) |
74
+ | `May 2026 Week 4` | 180 | 396 | 96 | 한 줄 (32) |
75
+
76
+ ### 고친 자리 ② 영어 — **달 이름을 줄인다.** 늘리는 것만으로는 머리가 접힌다
77
+
78
+ 영어 긴 꼴은 상자가 **229** 가 되고, 그러면 **카드 머리가 두 줄로 접힌다**(키 32 → **63**).
79
+ 예순 가운데 **마흔이** 그랬다. 그 카드는 540 × 260 에 머리가 한 줄로 서야 하는 자리라
80
+ (`CHART_HEAD_SIZE` 참고) 거기까지 늘릴 수 없다.
81
+
82
+ 그래서 영어 `calendar.yearMonthCompact` 를 `{{full}}` → `{{short}}` 로 바꿨다 —
83
+ `September 2026` 이 **`Sep 2026`** 이 된다. `formatYearMonthShort` 를 `utils/date.ts` 에
84
+ 두고, **`formatYearMonth`(긴 꼴)은 그대로** 둔다 — 달력 머리줄(`Calendar`)이 쓰는 자리라
85
+ 거기서는 달 이름이 온전히 보여야 한다.
86
+
87
+ **`Sep` 도 달 이름이다.** 영어에 달 이름이 보여야 한다는 것(`yearMonthEverySite`)은 그대로고,
88
+ 줄인 것은 이름이 아니라 길이다.
89
+
90
+ **줄인 꼴도 150 에는 안 들어간다**(최소 117.6 · 최대 130.3 > 100) — 상자가 늘어야 한다.
91
+
92
+ ### 고친 자리 ③ 영어 주 이름표 — `Week 4` → `W4`. **①+② 만으로는 제목이 접혔다**
93
+
94
+ ①+② 까지 하고 재 보니 **영어에서 제목이 두 줄로 밀려났다.** 달 이름만 줄여도 상자가
95
+ **180** 이 되어 제목에 **96** 만 남는데, 실제 영어 제목이 그보다 넓다(말귀_2 실측):
96
+
97
+ | 카드 제목 | 폭 | 상자 180(제목 96) | 상자 151(제목 125) |
98
+ |---|---|---|---|
99
+ | `Visit Details` | 80.3 | 한 줄 | 한 줄 |
100
+ | `Store Detail` | 79.4 | 한 줄 | 한 줄 |
101
+ | `Training Details` | 105.3 | **두 줄** | 한 줄 |
102
+ | `Homework Detail` | 116.8 | **두 줄** | 한 줄 |
103
+ | `Homework Completed` | 152.9 | **두 줄** | **두 줄** (고르개 없는 카드) |
104
+
105
+ 제목은 `white-space: normal` · `overflow: visible` 이라 **끊기지 않고 접힌다.** 접히면 머리
106
+ 키가 **32 → 59** 가 되어 그만큼 판을 밀어낸다 — 그 카드는 머리가 한 줄이어야 260 을 지킨다
107
+ (사장님 지시 *"높이 260 으로 고정시키고 그 안에 그래프가 맞춰지도록 해"*, 0.415.0).
108
+
109
+ 그래서 **고르개의 주 이름표만** 짧은 꼴을 쓴다(`weekLabelCompact`, 영어 `W4`) — 상자가
110
+ **151** 이 되고 제목에 **125** 가 남아, 고르개가 붙은 카드 넷이 모두 한 줄에 선다.
111
+
112
+ **`calendar.weekLabel` 은 안 건드렸다.** 긴 꼴을 쓰는 자리가 셋인데(막대 밑글 · 고르개 ·
113
+ 회원앱 `periodLabel`) **모자란 것은 고르개의 폭뿐**이다. 통째로 줄이면 나머지 둘의 글까지
114
+ 바뀐다 — 그래서 `yearMonthCompact` 가 `yearMonth` 의 짧은 짝인 것과 **같은 꼴로** 짝을 하나
115
+ 뒀다. 글귀는 여전히 사전이 쥔다. **한국어는 긴 꼴과 같은 값을 적는다** — `첫째주` 가 이미
116
+ 짧아 줄일 것이 없다(`2026.10 다섯째주` 116 · 상자 166 · 제목 110, 한 줄).
117
+
118
+ 처음에는 한국어에 **안 적고** 물러섬에 맡겼는데 **사전 짝 못이 막았다**(`i18nLocaleParity`:
119
+ *"en 에 있는 열쇠는 ko 에도 있다 — 한쪽만 지우면 고아가 남는다"*). 그 못이 옳다 — 짝이 없는
120
+ 열쇠는 **번역을 빠뜨린 것**과 **일부러 안 적은 것**이 글자로 안 갈린다. 물러섬 자체는
121
+ 두 말 밖을 위해 남겼다.
122
+
123
+ ### 셋이 **왜 함께** 가야 하나
124
+
125
+ | 넣은 것 | 한국어 | 영어 |
126
+ |---|---|---|
127
+ | 아무것도 (0.415.0) | 이름표 **20/60 끊김** | 이름표 **60/60 끊김** · 머리 한 줄 |
128
+ | ① 만 | 끊김 **0** · 머리 한 줄 | 끊김 0 · **머리 두 줄**(상자 229) |
129
+ | ①+② | 끊김 0 · 한 줄 | 끊김 0 · **제목 셋이 두 줄**(상자 180) |
130
+ | **①+②+③** | **끊김 0 · 한 줄** | **끊김 0 · 한 줄**(상자 151) |
131
+
132
+ ### 남은 것 — `Homework Completed`
133
+
134
+ 제목 **152.9** 는 상자 151 에서도 접힌다. 그 카드에는 **지금 고르개가 없어서** 이 판에서는
135
+ 문제가 아니다. 거기에 고르개가 붙는 날에는 제목을 줄이거나 말줄임을 두어야 하고, **그것은
136
+ 눈에 보이는 결정**이라 사장님께 여쭐 일이다. 적어만 둔다.
137
+
138
+ ### 곁딸린 것 — 막아 선 시험이 **값을 박고 있었다**
139
+
140
+ `yearMonthEverySite` 가 긴 달 이름 **열두 개를 글자로 박고** 있어서 이 고침을 막아 섰다.
141
+ 제목이 *"영어에서는 달 이름이 보인다 — 번호가 아니라"* 인데, 지키려는 것은 **이름이
142
+ 보이는가**이고 긴 꼴 목록은 *"어느 꼴로 적는가"* 까지 박은 것이었다. 그래서 **줄인 꼴까지
143
+ 받게 넓히고**, 대신 *"번호가 아니라"* 를 **따로 세게** 했다 — 전에는 긴 이름 목록이 숫자를
144
+ **덤으로** 걸러서 그 말이 못으로 서 있지 않았다.
145
+
146
+ ### 소비처가 볼 것
147
+
148
+ - **영어 화면의 기간 고르개 글이 바뀐다** — `September 2026 Week 4` → **`Sep 2026 W4`**.
149
+ 한국어는 **그대로**(`2026.11 첫째주`). 달력 머리줄·`DatePicker` 의 긴 꼴도 그대로고,
150
+ **막대 밑글과 회원앱 `periodLabel` 의 `Week 4` 도 그대로다** — 짧은 꼴은 고르개만 쓴다.
151
+ - 새 이름 둘이 나간다 — `formatYearMonthShort`(`utils/date`) · `weekLabelCompact`
152
+ (`components/barChartData`). 앱에서 짧은 꼴이 필요한 자리가 생기면 그것을 쓴다.
153
+ - `.month-dropdown .dropdown__trigger` 를 앱 CSS 에서 폭으로 덮고 있으면 **걷어야** 한다 —
154
+ 덮으면 늘어날 길을 다시 닫는다.
155
+ - 제목 칸이 최소 **96px** 까지 좁아진다. 긴 제목을 쓰는 차트 카드가 있으면 말줄임으로 끊길
156
+ 수 있으니 재어 보고 알려 주기 바란다.
157
+
158
+ 못은 `test/monthDropdownLabelFits1103.test.tsx` 12개다. **셋을 따로 깨 봤다** — CSS 만
159
+ 되돌리면 2개, 영어 달 이름만 되돌리면 2개, 짧은 주 꼴을 빼면 3개(고르개가 다시 긴 꼴을
160
+ 부르면 2개)가 울고, 다 되돌리면 초록이다. px 은 안
161
+ 박았다(jsdom 은 글 폭을 모른다) — **상자가 한 수에 다시 박히지 않았나**와 **영어가 긴 꼴로
162
+ 돌아가지 않았나**를 센다. 재는 것은 브라우저에서 했고 그 수가 위 표다.
163
+
164
+ ## 0.415.0 — 긴 묶음 카드가 다음 칸까지 쓴다 · **격자 카드의 바닥·큰 수가 맞는다** · 카드 제목 `darkGray` · x축 이름표 다시 두 줄 · 곁줄 발치는 붙박이
165
+
166
+ ### 격자에 선 카드끼리 **바닥도 큰 수도 안 맞고 있었다** (사장님 지시 넷)
167
+
168
+ 대시보드에서 차트 카드와 수 칸이 **한 격자에 나란히 선다.** 사장님이 그 줄을 네 번 짚으셨다
169
+ — *"또 안맞네?"* · *"여기도 안맞아"* · *"위치도 안맞아 확인해봐"* · *"살짝 아래로 내려가 있는
170
+ 느낌인데"*. 재 보니 네 가지가 따로 어긋나 있었다(실측 2026-11-02, 폭 1771).
171
+
172
+ | 짚으신 것 | 재어 보니 | 고친 자리 |
173
+ |---|---|---|
174
+ | 카드 바닥이 안 맞는다 | 차트 **270** · 수 칸 260 · 아래 칸 바닥 645 — 줄이 125 로 부풀었다 | 격자 카드는 **키를 박는다**(`height`), 판은 `fitHeight` 가 맞춘다 |
175
+ | 큰 수의 자리가 안 맞는다 | 차트 **440** · 수 칸 **425** (15px) — 머리가 32 대 **23** 이었다 | 수 칸 머리도 `CHART_HEAD_SIZE`, 격자 차트의 머리 아래 여백은 2 |
176
+ | 범례가 위로 붙어 보인다 | 범례 첫 줄 **754** · 큰 수 **756** — `h1` 줄상자의 윗여백 3px | 큰 수의 **남는 윗여백만** 걷는다(크기·단계는 안 건드린다) |
177
+ | 빈 글이 아래로 내려가 있다 | 위 **69** · 아래 **60** — `margin-block: auto` 위에 `gap` 이 얹혔다 | `--body-center` 에서는 틈을 `auto` 에게 넘긴다 |
178
+
179
+ **카드 키를 박은 것이 뿌리다.** 전에는 `canvasHeight` 를 손으로 맞춰 260 을 지켰는데(108 →
180
+ 97), 머리나 x축이 한 눈금만 달라지면 그만큼 어긋났다 — 그날 x축이 두 줄로 돌아가며 260 이
181
+ 270 이 됐고, 곁 카드 바닥이 10px 밀렸다. 이제 **카드가 260 을 쥐고 판이 남은 자리를 잰다**
182
+ (`BarChart fitHeight` · 사장님 지시 *"높이 260 으로 고정시키고 그 안에 그래프가 맞춰지도록
183
+ 해"*). 미끼로 **첫 값을 40 으로 줘 봐도 판은 93 으로 선다**(2026-11-02).
184
+
185
+ 재는 자리는 **감싼 상자**다 — 그 상자가 제 속만 감싸고 있으면 잴 것이 제 속뿐이라 **늘
186
+ 지금 값이 나온다**(처음에 그래서 안 늘었다). 격자 카드의 판은 `flex: 1` 로 남은 자리를 받는다.
187
+
188
+ ### 큰 수의 마크업을 **하나로** (사장님 지시)
189
+
190
+ *"이게 서로 다르네 하나는 sub-row고 하나는 section-content 네 하나로 통일해"* — 같은 자리의
191
+ 같은 수가 두 마크업이었다(수 칸 `__value-row > __value` · 차트 `__sub-row > __total >
192
+ __total__num`). 그래서 윗여백·글자 단계 같은 것을 고칠 때마다 **규칙을 두 벌씩** 써야 했고,
193
+ 그날도 **차트 쪽 한 자리를 빠뜨려** 큰 수의 윗여백이 그 카드만 안 들었다.
194
+
195
+ 이제 둘 다 `__sub-row` 안의 `ChartTotal` 이고, 공통 이름(`chart-section__value`)은
196
+ **`chartTotalNumClass()` 가 단다** — 큰 수를 그리는 자리가 다섯이라, 부르는 쪽마다 적으면
197
+ 한 자리가 또 빠진다. 옛 이름은 같은 요소에 **그대로 남겼다**(그 이름으로 찾는 시험·못이
198
+ 코어 46 · 앱 3).
199
+
200
+ 못 둘이 그 자리에서 울었고 **뜻을 뒤집어 고쳤다** — `stat 인데 차트 서브로우가 섰다` 는
201
+ 이제 *둘 다 있는지*를 잰다. 속이 또 갈라지는 날을 잡는 자도 하나 세웠다(감싼 상자·수의
202
+ 이름을 갈래끼리 맞댄다).
203
+
204
+ **이름까지 하나로 뗐다**(이어서 *"이거 진행해"*). 처음에는 옛 이름을 같은 요소에 함께
205
+ 달아 두었는데 — 그러면 소스를 읽는 사람이 **둘 중 어느 것이 진짜인지 묻게 된다**. 남긴
206
+ 쪽은 `__total__num` 이다: 감싼 상자(`__total`)·단위(`__total__unit`)와 한 결이라 셋이
207
+ 한 덩어리로 읽힌다. 걷은 쪽은 수 칸만 쓰던 `__value`·`__value-row`·`__value--muted` 로,
208
+ **규칙 셋이 하나로 접혔다**(색·줄바꿈·윗여백이 따로 서 있었다).
209
+
210
+ 겨누던 자리를 다 옮겼다 — 코어 CSS 6 · 마크업 3 · 시험 13, 앱 시험 3. 옛 이름으로 찾던
211
+ 앱 시험 하나(`barchart-total__num`)는 **그대로 맞는다** — `withLegacy` 가 내주는 그 이름은
212
+ `__total__num` 에 달려 있다. 화면에서도 쟀다(2026-11-02): 두 카드의 수가 **class 까지
213
+ 같은 한 줄**(`chart-section__total__num h1 barchart-total__num`)이고, 옛 이름을 단 마디는
214
+ **0 개**다.
215
+
216
+ 못도 하나 세웠다 — *옛 이름이 소스에 하나도 안 남았는지*. 미끼로 `.chart-section__value`
217
+ 한 줄을 CSS 에 도로 넣으니 빨개졌다.
218
+
219
+ **상자도 하나로**(이어서 *"여전히 디자인도 다르고 div 도 달라"*). 이름을 합친 뒤에도 수 칸만
220
+ 머리와 몸 사이에 `__content` 한 겹을 더 끼우고 있었다 — 차트·고리는 머리·큰 수 줄·몸이
221
+ 카드의 **직계**다. 걷었다: 그 한 겹이 하던 일(남는 키 먹기·위아래로 벌리기)은 카드가 이미
222
+ 세로 flex 라 카드가 든다. 가운데 표(`bodyAlign="center"`)도 카드 자신에 달린다.
223
+
224
+ **디자인이 다르던 것은 둘**이었고 하나는 그날 낮에 내가 만든 것이다. ① 머리 키 32 를
225
+ `--stat` 에만 박아, 수 칸은 막대 차트에 맞았지만 **고리 카드와 9px 어긋났다**(실측 378 대
226
+ 387) — 밑바탕 `.chart-section__head` 한 줄로 올리고, 그것을 도로 0 으로 되돌리던 `--compact`
227
+ 의 `min-height: 0` 을 걷었다. ② 큰 수 줄 아래 틈이 갈래마다 달랐다(고리 12 · 막대 8 · 수 칸 0)
228
+ — 격자에서는 8 하나로 두고, 아래에 몸이 없으면 0 이다(있으면 120 카드가 1px 넘친다).
229
+ `--compact`·`--stat` 규칙 **뒤에** 세워야 이긴다 — 처음엔 앞에 둬서 아무 일도 안 했다.
230
+
231
+ 재서 닫았다(2026-11-02, 폭 1771): 네 카드가 다 `head > sub-row > (body)` · `__content` 0 ·
232
+ 머리 32 하나 · 같은 줄 큰 수 387/387 · 407/407 · 빈 글 위 62 아래 63 · 넘침 0.
233
+ 수 칸 머리 못은 **뜻을 뒤집었다** — "박지 않는다" 에서 "모든 카드가 `CHART_HEAD_SIZE` 로
234
+ 같이 박는다" 로(까닭이 바뀌어서다).
235
+
236
+ ### 곁줄 발치가 잘리던 것 — **구르는 것은 목록뿐이다** (사장님 지시)
237
+
238
+ *"sidebar 하단이 잘려보이네?"* — 통 하나가 목록과 발치를 **함께** 굴리고 있었다(그 글은 원래
239
+ 저장소를 베껴 온 커밋에 그대로 들어온 것이라 까닭이 적혀 있지 않았다). 말귀매니저에 칸이 하나
240
+ 늘자(`숙제관리`) 내용이 통보다 **63px** 길어져 `설정`·`계정` 이 아래로 잘렸다(실측 2026-11-03,
241
+ 화면 키 1214: 내용 1161 · 통 1098 · 잘린 둘의 바닥 1205·1265).
242
+
243
+ **위로 올리는 쪽은 못 쓴다** — 발치를 바닥에 붙이면 범례처럼 머리 쪽과 겹친다. 통을
244
+ `__menu-list` 로 내리고 발치를 그 **밖**에 두었다. 칸이 몇이든 그 다섯은 늘 보이고 넘치는 것은
245
+ 목록만 구른다. 떠 있는 막대도 통 안으로 옮겼다(`sticky` 는 구르는 통 안에서만 제자리를 지킨다).
246
+
247
+ 실측(되고 난 뒤) — 잘린 단추 **0** · 발치 914~1202(통 바닥과 같다) · 목록 104~902 가 구른다
248
+ (864 / 798) · 막대 그대로.
249
+
250
+ 못 둘을 그 자리에서 고쳤다 — 굴림 시험이 `<nav>` 에 굴림을 보내 **조용히 0 을 보고** 있었고
251
+ (통이 바뀌어서다), 막대 숨김 자가 선택자 하나만 보던 것을 **통이 무엇이든** 보게 했다.
252
+
253
+ **그 바꿈이 막대를 잘라 먹고 있었다**(말귀_2 가 가로 넘침 14px 로 짚었고, 재 보니 그보다 나빴다).
254
+ 떠 있는 막대는 음수 여백으로 **통의 좌우 여백 안으로** 빠져나가는데, 통이 목록으로 내려가며 그
255
+ 여백이 `__menu` 에 남아 있었다 — 막대가 통 **밖**(211~217, 통은 207 에서 끝)으로 나가
256
+ `overflow-x: hidden` 에 **통째로 잘려 안 보이고 못 잡혔다**(실측 2026-11-03, 폭 1440).
257
+ 좌우 여백을 통으로 **옮겼다가 그날 되돌렸다** — 옮기니 발치가 그 여백을 잃어 단추 다섯이 항목과
258
+ 11px 어긋나고(항목 13 · 단추 2) 알림 배지가 화면 밖(−4)으로 나갔다(말귀_2 실측 · 청 (366)).
259
+ 여백은 `__menu` 에 두고 **구르는 목록만** 음수 여백으로 그 밖까지 폈다가 제 여백으로 되돌린다 —
260
+ 그러면 막대가 앉을 11px 이 통 **안**에 생기고 발치는 메뉴의 여백을 그대로 쓴다. 두 수가 늘 같아야
261
+ 하므로 `--rail-pad` 한 변수로 모았다(접힌 레일은 `Header.css` 가 그 변수만 바꾼다).
262
+ 항목 자리는 그대로고(좌우 틈 12/12), 막대가 다시 보이고 잡힌다. 잡는 자리(`::before`)의 오른쪽 4px 도 통 밖이라 **왼쪽으로
263
+ 옮겼다**(잡는 폭 12 → 18). 가로 넘침 **14 → 0**.
264
+
265
+ ### 범례는 **서브로우 밖 제 자리**에 선다 (사장님 지시)
266
+
267
+ *"legend 를 sub row 에서 분리해서 배치해줘. 상대적으로 위로 올라가있는걸 조정 못하겠어"* —
268
+ 서브로우 안에 큰 수와 나란히 두면 `align-items` 가 둘을 한 상자에 묶어 **범례만 따로 올리고
269
+ 내릴 손잡이가 없었다**(그날 큰 수의 윗여백을 깎자 범례가 따라 움직였다).
270
+
271
+ `ChartSection` 에 `legend` 프롭이 생겼다. `BarChart`·`RingChart` 가 범례를 거기로 넘기고,
272
+ 카드는 `__legend-slot` 으로 **오른쪽에 띄워** 세운다. 세로는 *큰 수 줄의 윗선 + `--legend-offset`*
273
+ 이다 — 그 윗선은 `카드 여백 + 머리 32 + 머리 아래 틈` 이라, 머리 여백을 적던 규칙 셋을
274
+ 변수 하나(`--head-gap`: 기본 8 · 격자/작은 카드/수 칸 2)로 모아 둘이 같은 수를 본다.
275
+
276
+ **`--legend-offset` 하나로 움직인다**(px, 기본 0). 0 이면 오늘과 같은 자리다 — 실측(2026-11-02,
277
+ 폭 1771): 자리 윗선 753 = 서브로우 윗선, 범례 첫 줄 754 · 큰 수 753, 수와 안 겹친다. 띄워
278
+ 세우므로 서브로우 폭을 안 먹는다 — 긴 범례가 수와 겹치지 않게 폭을 55% 로 막았다.
279
+
280
+ 밟은 것 — `--head-gap` 을 **둘째 `.chart-section--grid {` 블록**으로 덧세웠더니, 그 이름으로
281
+ 첫 블록을 찾던 못 셋이 내 것을 집어 빨개졌다. 원래 블록 안으로 넣었다.
282
+
283
+ `--legend-offset` 은 **4** 로 두었다(사장님 "3px 내려봐" 뒤에 "1px 더") — 실측 큰 수 글자
284
+ 531~569 · 범례 536~570.
285
+
286
+ **범례가 길면 큰 수 줄이 그만큼 넓어진다**(사장님 지시 2026-11-03 "legend 이 선 위로"). 띄워 세운
287
+ 뒤로 범례의 키가 줄에 안 들었는데, 계열이 **셋**이 되자 55px 이 되어 **첫 눈금선을 10px 넘었다**
288
+ (실측: 범례 바닥 113 · 눈금선 103). 위로 키우면 머리의 고르개와 겹치니 **아래가 밀리는 쪽**이 맞다 —
289
+ 잰 키를 카드가 `--legend-h` 로 적고 CSS 가 서브로우의 최소 키로 쓴다. 판은 `fitHeight` 가 남은
290
+ 자리를 다시 재어 저절로 줄어든다(실측: 눈금선 103 → 117 · 범례 바닥 113 · 판 96 → 82 · 카드 260
291
+ 그대로 · 머리와 안 겹침). 계열 둘인 카드 셋은 그대로다(94 / 103 / 판 96).
292
+
293
+ ### 박은 카드 키는 `inGrid` 가 아니라 **`fitBody`** 를 본다 (내가 깨뜨린 것)
294
+
295
+ 카드 키를 `inGrid` 에 묶어 두었더니 격자에 선 **모든** 차트 카드가 260 으로 박혔다 — 속을
296
+ 제 키에 맞추는 것은 대시보드 둘뿐이라, 고객 통계의 차트 여섯은 x축 둘째 줄을 **카드 밖으로
297
+ 흘렸다**(사장님 "아따 여기 죄다 깨졌네"). 격자에 섰다는 것과 속을 맞춘다는 것은 다른 말이다.
298
+ `BarChart fitHeight` 가 `ChartSection fitBody` 를 켜고, 그때만 키를 박는다(`--fit`).
299
+ 실측(2026-11-02): 고객 통계 여섯이 315~316 으로 다시 자라고 x축은 바닥 안쪽 20 · 대시보드
300
+ 둘은 260 그대로 · 판 96.
301
+
302
+ ### 빈 글의 가운데를 **눈이 보는 가운데로** (사장님 지시)
303
+
304
+ *"영역에서는 가운데일텐데 약간 아래로 쏠려보여 보정해줘"* — `auto` 는 큰 수 줄 **아래** 남는
305
+ 자리의 한가운데에 세우는데, 눈은 큰 수를 머리의 일부로 읽어 **머리 아래 전체**의 가운데를
306
+ 기대한다. 그 차이가 큰 수 줄(41)+틈(2)의 반, 21 이다. 몸 상자 아래에 그 두 배를 덧대
307
+ `auto` 가 그만큼 위로 밀게 했다(`--body-lift`, 기본 21). 실측: 글 가운데 846 · 머리 아래
308
+ 자리의 가운데 845.5(전에는 872, 카드 가운데보다 27 아래).
309
+
310
+ ### 그 밖
311
+
312
+ - **`없음` 은 `lightGray`** (사장님 지시) — 값이 수가 아니라 **빈 것을 이르는 말**일 때.
313
+ 코어는 그 글자를 못 알아보니 부르는 쪽이 `totalMuted` 로 말해 준다. 못 받음(`—`)은 안 낮춘다.
314
+ - **범례 틈 6 → 2** (사장님 지시 *"Legend 간격 줄여봐"`*) — 두 줄 범례가 40 → 36.
315
+
316
+ ### x축 이름표를 **다시 두 줄로** (사장님 지시)
317
+
318
+ *"이거 다시 두줄로 바꿔야 겠다."* — 0.414.0 에서 한 줄로 세웠던(`2~8 첫째주`) 것을
319
+ 위아래로 되돌린다.
320
+
321
+ **그때 잰 칸이 넓은 쪽이었다.** 한 줄로 바꾸며 *"칸 폭이 125 라 한 줄로도 넉넉하다"* 고
322
+ 적었는데, 125 는 대시보드의 **넓은 차트**였다. 같은 부품이 고객 통계에서는 칸이 **60px** 이라
323
+ `23~29 셋째주` 가 한 줄에 못 서고 **수 한가운데서 끊겼다** — 화면에 `23~2` / `9` 로 떴다.
324
+
325
+ 실측(2026-11-02, 되돌린 뒤) — 칸 60px 에서 글자 상자 31~46px · 두 줄(35px) · 끊긴 수 0 ·
326
+ 넘침 0(375 · 1771 둘 다). x축은 23 → 41 로 돌아갔고 카드가 잘리지는 않는다(258/260).
327
+
328
+ ### 긴 묶음 카드가 **옆 칸을 덮고 있었다** (사장님 지시)
329
+
330
+ *"가로가 길면 다음 칸 까지 사용하도록 해야지?"* — `가운뎃손가락 다리미질하다 콘트라베이스`
331
+ 묶음이 셋째 낱말부터 잘려 보인다고 짚으셨다.
332
+
333
+ **잘린 것이 아니라 덮인 것이다.** 격자는 200px 고정 열인데 단추는 글 길이만큼 넓어지고
334
+ (`min-width: 200px`, 넘침을 안 감춘다), 넘친 만큼이 **옆 칸 위로 가서 옆 카드가 그 위에
335
+ 그려진다.** 실측(2026-11-02 · 폭 1420 · 50묶음): 열 200 × 6 · 틈 8 · 그 단추 **262px** 라
336
+ 62px 을 덮었다. 넘치는 묶음은 셋이었다.
337
+
338
+ **아무 자도 못 잡는 꼴이다** — `scrollWidth` 는 격자가 아니라 제 상자를 재니 260 = 260 으로
339
+ **넘침 0**, `overflow` 는 `visible` 이라 구르지도 잘리지도 않는다.
340
+
341
+ 격자는 **칸 수를 글 길이로 못 정한다**(`max-content` 로 열을 잡으면 가장 긴 묶음의 폭이 모든
342
+ 열에 퍼진다). 그래서 **재서 칸 수를 적는다** — `useWideCardSpans`. 열 폭과 틈은 격자에게
343
+ 묻고, 그리기 직후에 재며(`useLayoutEffect`), 폭이 바뀌면 `ResizeObserver` 로 다시 잰다.
344
+ **넓힌 칸은 카드가 채운다**(`[data-wide]`) — 칸만 넓히면 오른쪽에 146px 이 빈다.
345
+
346
+ 고친 뒤 실측 — 셋 다 `span 2`(408px) · **덮는 것 0 · 빈 틈 0.**
347
+
348
+ **소비처가 볼 줄** — `WordSearchResultBlock` 을 쓰는 자리는 **아무것도 안 해도 된다**(블록이
349
+ 제 안에서 잰다). `useWideCardSpans` 는 밖에서도 쓸 수 있게 열어 두었다 — 200px 같은 **고정 열
350
+ 격자에 내용 폭이 제각각인 카드**를 놓는 자리가 있으면 같은 꼴이다.
351
+
352
+ ### 카드 제목 색은 `darkGray` (사장님 지시)
353
+
354
+ *"title 컬러를 밝게 올렸냐?"* — 그랬다. 0.414.0 에서 *"동일하게 해야지"* 로 갈래 셋을
355
+ 맞추며 **작은 쪽(`h5`·deepGray)에 맞춰 내렸고**, 그 바람에 큰 차트 카드 제목이 전(`h3`·
356
+ 20px·#111)보다 옅어졌다. *"darkGray 로"* 하셔서 한 단 올렸다(#434d56, 흰 바탕 **8.63:1**).
357
+ 셋이 같은 것은 그대로다.
358
+
359
+ ### 폰에서 수 칸의 **그림씨가 제 줄로 내려가 있었다**
360
+
361
+ `@media (max-width: 767px)` 가 머리를 세로로 세운다. 그 규칙은 **차트 카드** 때문에 있다 —
362
+ 오른쪽이 조절칸 한 줄(실측 299px)이라 폰에서 제목 옆에 못 선다. 그런데 **수 칸**의 오른쪽은
363
+ **18px 그림씨 하나뿐**인데 같이 세워져서, 그림씨가 제 줄로 내려가 **왼쪽에 홀로** 섰다
364
+ (실측: 제목 y 356 · 그림씨 y 388, x 는 둘 다 213). 대시보드 열여덟 칸 중 **열여섯이 그 꼴.**
365
+
366
+ 머리의 자식으로 가른다 — 수 칸은 `__title` + `__head-icon`, 고리 카드는 `__head-right` 안에
367
+ **그림씨 외동**, 차트 카드는 `__head-right` 안에 `__controls`. `:has()` 와 `:only-child` 로
368
+ 앞의 둘만 줄로 되돌린다. 고친 뒤 실측(375) — 줄로 선 머리 **16** · 세운 것은 차트 **둘뿐.**
369
+
10
370
  ## 0.414.0 — 조절칸은 **40 그대로** (32 로 쓸었다가 같은 날 되돌렸다) · 차트 카드 한 벌 · 긴 제목이 쪽을 옆으로 밀지 않는다 · 그룹 머리의 단추가 안 잘린다
11
371
 
12
372
  ### 되돌림 — **`CONTROL_SIZE` 는 40 이다** (사장님 지시, 2026-11-02 저녁)