@ihabdevteam/core 0.412.0 → 0.414.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 (65) hide show
  1. package/CHANGELOG.md +663 -0
  2. package/dist/components.cjs.js +178 -177
  3. package/dist/components.esm.css +2 -2
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core.cjs.js +184 -183
  7. package/dist/ihabdevteam-core.d.ts +306 -19
  8. package/dist/packages/core/src/components/Accordion.css +16 -0
  9. package/dist/packages/core/src/components/BarChart.css +16 -8
  10. package/dist/packages/core/src/components/BarChart.d.ts +1 -1
  11. package/dist/packages/core/src/components/BarChart.js +13 -11
  12. package/dist/packages/core/src/components/BulkBar.js +2 -1
  13. package/dist/packages/core/src/components/ChartSection.css +193 -25
  14. package/dist/packages/core/src/components/ChartSection.d.ts +94 -2
  15. package/dist/packages/core/src/components/ChartSection.js +92 -7
  16. package/dist/packages/core/src/components/ColorPicker.d.ts +2 -1
  17. package/dist/packages/core/src/components/ColorPicker.js +2 -1
  18. package/dist/packages/core/src/components/DatePicker.css +5 -0
  19. package/dist/packages/core/src/components/DatePicker.d.ts +2 -1
  20. package/dist/packages/core/src/components/DatePicker.js +1 -1
  21. package/dist/packages/core/src/components/Dropdown.css +6 -0
  22. package/dist/packages/core/src/components/Dropdown.d.ts +2 -1
  23. package/dist/packages/core/src/components/FilterPanel.js +17 -3
  24. package/dist/packages/core/src/components/Header.js +4 -4
  25. package/dist/packages/core/src/components/Panel.css +53 -6
  26. package/dist/packages/core/src/components/RingChart.js +10 -6
  27. package/dist/packages/core/src/components/SegmentedControl.css +6 -1
  28. package/dist/packages/core/src/components/SegmentedControl.d.ts +5 -1
  29. package/dist/packages/core/src/components/SegmentedControl.js +2 -1
  30. package/dist/packages/core/src/components/SideNav.js +1 -1
  31. package/dist/packages/core/src/components/StatChart.d.ts +22 -11
  32. package/dist/packages/core/src/components/StatChart.js +17 -37
  33. package/dist/packages/core/src/components/SummaryStrip.d.ts +1 -1
  34. package/dist/packages/core/src/components/SummaryStrip.js +1 -1
  35. package/dist/packages/core/src/components/Table.d.ts +36 -1
  36. package/dist/packages/core/src/components/Table.js +127 -15
  37. package/dist/packages/core/src/components/Tabs.d.ts +2 -1
  38. package/dist/packages/core/src/components/Tabs.js +2 -1
  39. package/dist/packages/core/src/components/TextField.css +20 -1
  40. package/dist/packages/core/src/components/TextField.d.ts +7 -1
  41. package/dist/packages/core/src/components/TextField.js +2 -1
  42. package/dist/packages/core/src/components/Training/TrainingCardGroup.css +22 -3
  43. package/dist/packages/core/src/components/Word/WordSearchResultBlock.js +2 -1
  44. package/dist/packages/core/src/components/Word/WordTableBlock.js +27 -7
  45. package/dist/packages/core/src/components/WordTable.js +25 -1
  46. package/dist/packages/core/src/components/barChartTypes.d.ts +12 -0
  47. package/dist/packages/core/src/components/controlSize.d.ts +87 -1
  48. package/dist/packages/core/src/components/controlSize.js +87 -1
  49. package/dist/packages/core/src/components/tableFitWidths.d.ts +19 -0
  50. package/dist/packages/core/src/components/tableFitWidths.js +26 -0
  51. package/dist/packages/core/src/components/useBarChartControl.js +27 -7
  52. package/dist/packages/core/src/components.d.ts +3 -3
  53. package/dist/packages/core/src/components.js +1 -1
  54. package/dist/packages/core/src/i18n/locales/en.json +1 -0
  55. package/dist/packages/core/src/i18n/locales/ko.json +1 -0
  56. package/dist/packages/core/src/utils/imageCompression.d.ts +109 -0
  57. package/dist/packages/core/src/utils/imageCompression.js +163 -0
  58. package/dist/packages/core/src/utils/legacyBlocks.js +5 -1
  59. package/dist/packages/core/src/utils.d.ts +1 -0
  60. package/dist/packages/core/src/utils.js +3 -0
  61. package/dist/packages/core/src/version.d.ts +1 -1
  62. package/dist/packages/core/src/version.js +1 -1
  63. package/dist/utils.cjs.js +164 -164
  64. package/package.json +1 -1
  65. package/dist/packages/core/src/components/StatChart.css +0 -93
package/CHANGELOG.md CHANGED
@@ -7,6 +7,669 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.414.0 — 조절칸은 **40 그대로** (32 로 쓸었다가 같은 날 되돌렸다) · 차트 카드 한 벌 · 긴 제목이 쪽을 옆으로 밀지 않는다 · 그룹 머리의 단추가 안 잘린다
11
+
12
+ ### 되돌림 — **`CONTROL_SIZE` 는 40 이다** (사장님 지시, 2026-11-02 저녁)
13
+
14
+ 낮에 32 로 내려 코어·회원앱·어드민을 쓸었는데, 쓸린 화면을 보시고 **되돌리라 하셨다** —
15
+ 단어검색 툴바의 드롭다운 둘과 `PanelRow` 의 `이름` 글상자(32 · 글자 14px · 키 30)를
16
+ 고르시며 ***"이런거 작게 만든거 다 되돌려놔. chartsection 빼고"***.
17
+
18
+ **그래서 이 판에서 32 로 남는 것은 `ChartSection`·`BarChart` 머리의 조절칸뿐이다** —
19
+ 애초 지시가 그 넷을 가리킨 것이었으니 거기만 손으로 32 를 적는다. 그 카드는 540 × 260 에
20
+ 머리가 한 줄로 서야 해서 수가 작아야 맞고, 그 까닭은 다른 줄·머리에는 없다.
21
+
22
+ **소비처가 할 일** — 줄·머리를 코어가 짓는 자리는 저절로 40 으로 돌아온다. 되돌린 자리:
23
+ 회원앱 171자리/73파일(말귀_1) · 어드민 99자리(말귀_1 57 + 말귀_3 42). 둘 다 통째 치환이
24
+ 아니라 **쓸기 커밋의 diff 에서 수 하나만 다른 짝을 뽑아 그 짝만** 뒤집었다 — 쓸기 전부터
25
+ 32 였던 자리(`Pagination` · 간편 생성 28/32/40/48/56 사다리)를 먹지 않기 위해서다.
26
+ 어드민은 파일마다 **남은 `size=32` 수가 쓸기 전과 정확히 같은 것**까지 확인했다.
27
+
28
+ **아래 절들은 지우지 않는다.** 32 로 쓸린 동안 재어 둔 수가 적지 않고(글자 급 14/16/13,
29
+ 여러 줄 칸 열하나, 맨손 자리 셈), **다음에 누가 작은 급을 다시 꺼낼 때 그 표가 필요하다.**
30
+ 다만 *"공용 수는 32"* 를 전제로 쓴 문장은 지금 거짓이므로, 각 절 머리에 그 줄을 얹었다.
31
+
32
+ **되돌림으로 다시 생긴 어긋남 둘** — 둘 다 **쓸기 전에도 그랬던 것**이라 고치지 않고 적어만
33
+ 둔다: `WordSearchResultBlock` 툴바의 드롭다운 둘이 40 인데 바로 옆 `Pagination` 은 32,
34
+ 그리고 `FilterPanel` 한 절 안에서 드롭다운 갈래가 40 · 고르개 갈래가 32(옆 항목 단추에
35
+ 맞춘 `size="keyboard"` 가 닻이라 공용 수와 함께 움직이지 않는다).
36
+
37
+ **글자 급 셋(14/16/13) 이야기는 접혔다** — 32 가 사라지면 `TextField` 의 14px 도 같이
38
+ 사라지므로 어긋남 자체가 없어진다. 센 표는 아래에 그대로 남겨 둔다.
39
+
40
+ ### ~~**`CONTROL_SIZE` 40 → 32**~~ — **같은 날 되돌렸다**(위 절 참조)
41
+
42
+ > 이 절은 **낮에 있었던 일의 기록**이다. 이 판이 내주는 수는 **40** 이다.
43
+
44
+ 2026-10-29 에 40 으로 내렸던 공용 조절칸 수를 **32 로** 다시 내렸다(사장님 지시 2026-11-02
45
+ *"size 모두 32 로"*, 범위는 *"줄·머리 전부"*). `components/controlSize.ts` 한 줄이다.
46
+
47
+ **소비처가 할 일** — 줄·머리를 코어가 짓는 자리는 저절로 따라온다. 직접 `size={40}` 을
48
+ 적어 둔 자리가 있으면 **그 자리만 40 으로 남는다.** 말귀매니저 쪽은 2026-11-02 에 앱
49
+ 33파일을 함께 옮겼다.
50
+
51
+ `Dropdown`·`DatePicker` 에 **32 급을 깔았다** — 키 32 · 모서리 8(집안 사다리 32→8 ·
52
+ 40→10 · 48→12). 나머지 넷은 (408) 에서 따라왔다.
53
+
54
+ ### `StatChart` 를 `ChartSection` 에 합쳤다 — `type` 으로 가른다 (사장님 지시)
55
+
56
+ 사장님이 *"chartsection과 statChart 가 같은 보더, 같은 타이틀, 같은 value, 같은 아이콘 등
57
+ 공통되는 게 많은데 컴포넌트는 그렇게 안 되어 있거든"* 하셨고, *"하나로 합쳐. type 으로 전부
58
+ 분기해"* 로 정하셨다.
59
+
60
+ `ChartSection` 이 `type: 'chart' | 'stat'` 을 받는다. **`StatChart` 는 남는다** —
61
+ `@deprecated` 껍데기로, 제 꼴 없이 이름만 옮겨 `<ChartSection type="stat">` 으로 넘긴다
62
+ (`label`→`title` · `value`→`totalNum`). 쓰던 자리는 그대로 돌아간다.
63
+
64
+ CSS 도 한 집안으로 모았다(`chart-section*`). `legacyBlocks` 의 `RENAMED` 에서
65
+ `stat-chart__card` 줄을 걷었다 — 그 이름이 가리키던 앱 클래스가 없어졌다.
66
+
67
+ **합치며 드러난 흠 하나** — 고리 카드가 큰 수의 크기를 `32px` 로 **베껴 적고** 있어서,
68
+ `StatChart` 쪽만 글자 급을 옮기면 둘이 조용히 갈렸다. 한 규칙으로 묶었다.
69
+
70
+ ### `ChartSection.size` 급 넷 — `small`·`medium`·`large`·`xLarge` (사장님 지시)
71
+
72
+ 사장님이 *"size xLarge 4개로 구분해 봐"* · *"small → 260 × 120 으로 하자"* ·
73
+ *"size medium 의 높이는 size small 의 높이 ×2 + 간격"* 하셨다.
74
+
75
+ | 급 | 크기 |
76
+ |---|---|
77
+ | `small` | 260 × **120** |
78
+ | `medium` | 260 × **260** (= 120 × 2 + 틈 20) |
79
+ | `large` | 540 × 260 (= small 2 × 2) |
80
+ | `xLarge` | 가로 전체 |
81
+
82
+ **틈이 14 → 20 으로 올랐다**(`--spacing-l`). `medium` 이 `small` 둘과 **정확히 같은 키**가
83
+ 되는 것이 이 수들의 뜻이다 — 어긋나면 격자에 구멍이 난다.
84
+
85
+ `bodyAlign: 'bottom' | 'center'` 도 함께 들어왔다(빈 카드의 글을 가운데로).
86
+
87
+ ### 큰 수는 `h1` · 단위는 `body-3` (사장님 지시)
88
+
89
+ 카드 제목은 셋 다 `h5`/`deepGray`, 큰 수는 `h1`(32px/700), 수 옆 단위는 `body-3` 이다.
90
+ 크기·굵기는 **표시의 클래스**에서 온다 — CSS 는 자간과 색만 든다. 좁은 카드의 수를 고르는
91
+ 짝으로 `chartTotalNumClass(small?)` 을 함께 내준다.
92
+
93
+ ### `BarChart.canvasHeight` — 그림 높이만 따로 (사장님 지시)
94
+
95
+ 사장님이 *"540 × 260 으로 둘 다 못 박는다. 안에 내용을 조정해"* 하셔서, 막대그림의 키만
96
+ 밖에서 줄 수 있게 열었다. `BAR_SIZE_PRESET`(small 100 · medium 140 · large 180)은
97
+ **그대로 뒀다** — `medium` 을 내리면 시험 14 개가 빨개진다.
98
+
99
+ 같이 든 둘 — 달 고르개 폭 150px 고정, x축 이름표를 **한 줄로**(세로 41 → 23).
100
+
101
+ ### (408) 기본값 넷도 32 — 말귀_3 청
102
+
103
+ > **되돌림 뒤**: 기본값 넷을 `CONTROL_SIZE` 에 맨 것은 **그대로 둔다** — 수가 40 으로
104
+ > 돌아가면 넷도 40 으로 따라오므로 지시대로 되고, *"손으로 적은 수를 기본값에 두지
105
+ > 않는다"* 는 까닭은 **수와 무관**하다. 아래의 '32' 는 낮의 수다.
106
+
107
+ 2026-11-02 에 `CONTROL_SIZE` 가 32 로 내려갈 때 **32 가 깔린 것은 `Dropdown`·`DatePicker`
108
+ 둘뿐**이었다. `TextField`·`SegmentedControl`·`Tabs`·`ColorPicker` 의 기본값은 **40 에
109
+ 남아 있었다.** 코어가 줄·머리를 지을 때는 공용 수를 손에 넘기니 눈에 보이는 흠이 없었는데,
110
+ **`size` 를 안 주고 부른 자리만 40 으로 섰다.**
111
+
112
+ 실측(2026-11-02 · 맨손으로 부르는 자리를 세고 띄워서 붙는 클래스를 확인):
113
+
114
+ | | 어드민 | 회원앱 | 코어 |
115
+ |---|---|---|---|
116
+ | `TextField` | **5** | **3** | **3** |
117
+ | `SegmentedControl` | 0 | 0 | 0 |
118
+ | `Tabs` | 0 | 0 | 0 |
119
+ | `ColorPicker` | 0 | 0 | 0 |
120
+
121
+ 어드민 업체 등록 창에서는 **바로 아래 `Dropdown` 이 이미 32** 라, 한 창에 40 과 32 가
122
+ 나란히 섰다. 코어 쪽 하나는 `FilterPanel` 의 거르개 글상자인데 **옆 갈래(세그먼트·드롭다운)가
123
+ 이미 32** 였다 — (407) 과 같은 자리의 같은 흠이다.
124
+
125
+ 넷 다 기본값을 `CONTROL_SIZE` 로 바꿨다. **48·64 가 맞는 자리는 그 자리에 적는다** —
126
+ 말귀_3 이 (405) 에서 *"`TextField` 기본을 40 으로"* 를 청했던 것을 스스로 되물렀고,
127
+ 그때 쓴 말이 그대로 지금 까닭이다.
128
+
129
+ **곁딸린 흠 하나 — 여러 줄 칸의 글자가 14px 로 내려앉았다.** `.text-field--s32` 가 글자를
130
+ 줄이는 까닭은 *박스가 작아서*인데(그 자리 주석에 그렇게 적혀 있다) **여러 줄 칸의 박스는
131
+ 작지 않다** — 키가 `size` 가 아니라 `rows` 에서 오고 `min-height: 80px` 이다. 크기별 **키**
132
+ 규칙들은 `--textarea` 를 이미 빼 두었는데 **글자 규칙만 그 제외를 빠뜨리고 있었다.**
133
+
134
+ 실측 2026-11-02 — 말귀_1: 회원앱 `HelpPage` '문의 내용' 칸 **14px**, 곁 본문 16px(쪽의 글자
135
+ 분포 16px 20자리 · 14px 17자리). 말귀_3: 어드민 반려 사유 칸 `--s32` **14/22** ↔ `--s40`
136
+ **16/26**, 곁 `body-2b` 16/26.
137
+
138
+ 처음에는 부르는 자리마다 `size={40}` 을 적어 막았다 — 그건 **부르는 사람이 기억해야 하는
139
+ 우회**다. 말귀_1 이 셋째 자리를 재어 오면서 *"규칙이면 앱에 적겠고, CSS 쪽이 맞으면
140
+ 청하겠다"* 고 **되물어** 왔고 그 물음이 맞았다. 규칙 한 줄에 제외를 두고(`:not(.text-field
141
+ __input--textarea)`) **코어 쪽 우회 둘을 걷었다** — 안 주고 불러도 맞는다. 줄간은
142
+ `--textarea` 제 규칙(`line-height: 1.6`)이 받는다.
143
+
144
+ `--auto`(한 줄에서 시작해 늘어나는 꼴)는 **그대로 줄인다** — 그쪽 박스는 처음에 `size`
145
+ 키(32 → 30px)를 받으므로 줄이는 까닭이 그대로 있다. 아이콘은 안 건드렸다(여러 줄 칸에
146
+ 아이콘을 주는 자리가 코어·앱 어디에도 **0** 이다).
147
+
148
+ **소비처가 볼 줄 — `--s32` 여러 줄 칸(`multiline`)의 글자가 14px → 16px 로 올라간다.**
149
+ 두 앱과 코어의 글상자를 `multiline`/`newline` 으로 갈라 세었다(2026-11-02, 말귀_3 과 각각
150
+ 따로 세어 수가 맞았다):
151
+
152
+ | | 몇 | 글자 |
153
+ |---|---|---|
154
+ | `multiline`(`--textarea`) | 앱 **8** · 코어 **3** | 14 → **16px** |
155
+ | `newline`(`--auto`) | 앱 **2** | **그대로 14px** |
156
+
157
+ - **앱 여덟** — 회원·매니저 다섯: 방문 메모 셋(`CustomerVisitEditPopup`·
158
+ `CustomerVisitRegisterPopup`·`VisitCreatePopup`, `rows=3`) · 도움말 '문의 내용'
159
+ (`HelpPage`, `rows=4`) · 낱말 추가 창(`WordAddPopup`, **`<PanelRow multiline rows=3>`**).
160
+ 어드민 셋: FAQ 답변(`FaqSection`) · 공지 상세(`InquiriesPage`, `rows=4`) · 반려 사유
161
+ (`WordSuggestionsPage`, `rows=3`).
162
+ - **코어 셋** — `SaveTablePopup`(설명) · `WordTableBlock`(설명) · `PanelRow` 의 여러 줄 갈래
163
+ (`variant="input"` + `multiline`, 공용 수를 넘긴다).
164
+ - **안 바뀌는 둘** — `CompanyEditPopup` 의 `newline` 칸 둘. `--auto` 는 처음 박스가 `size`
165
+ 키를 받으므로 **그대로 줄인다.**
166
+
167
+ **이 수를 세 번 고쳐 적었다 — 까닭이 한 가지다.** `<TextField multiline>` 만 찾았다.
168
+ `PanelRow` 는 **조절칸이 아니라 조절칸을 낳는 것**이라, `<PanelRow variant="input"
169
+ multiline>` 은 그 그물에 안 걸린다. 코어에서 하나(`PanelRow` 제 안), 앱에서 하나
170
+ (`WordAddPopup`)가 그렇게 빠졌다. 말귀_3 은 같은 꼴에 하루 세 번 걸렸다 —
171
+ `<PanelRow size={40}>`(크기를 프롭으로 받는다) · `btnSize`(제 단추에 크기를 준다) ·
172
+ `<PanelRow multiline>`(꼴을 프롭으로 받는다).
173
+
174
+ **낳는 쪽을 먼저 세고 잎을 센다.** 코어에서 `TextField` 를 속으로 그리는 조각은 여섯이고,
175
+ 그 가운데 **부르는 쪽의 `multiline` 을 넘기는 것은 `PanelRow` 하나**다(`Toolbar`·
176
+ `FilterPanel`·`ConsentRecordPopup` 은 안 넘기고, `SaveTablePopup`·`WordTableBlock` 은
177
+ 스스로 적는다). 그러니 `multiline` 을 셀 때 봐야 할 태그는 `TextField` 와 `PanelRow` 둘이다.
178
+
179
+ > **같은 자를 다시 돌릴 사람에게** — 태그를 가리지 않고 `newline` 이라는 **낱말**로 세면
180
+ > `<FilterPanel align="newline">` 네 자리가 걸린다. 그건 칸 모드가 아니라 **배치 값**이다
181
+ > (`align?: 'inline' | 'newline'`). 낱말이 아니라 **프롭 이름**으로 센다.
182
+
183
+ 받은 뒤 실측: 한 줄 칸은 14px/22 그대로, 여러 줄 칸은 **16px/25.6 · 키 124** —
184
+ `size={40}` 을 박았을 때와 **같은 키**다(말귀_1, `/help`). 어드민 반려 사유 칸도 16px 로
185
+ 곁글과 맞았다(말귀_3).
186
+
187
+ ### 그 한 줄이 한쪽은 맞추고 한쪽은 어긋낸다 — **사장님 눈이 필요하다**
188
+
189
+ > **접혔다** — 32 가 되돌려져 `s32` 글자 규칙에 닿는 자리가 없어졌다. 실측표는 남겨 둔다.
190
+
191
+ 받은 뒤 **열한 자리 가운데 일곱을 화면에서 쟀다.** 수가 갈렸다.
192
+
193
+ | | 곁의 조절칸 | 여러 줄 칸 | |
194
+ |---|---|---|---|
195
+ | 방문 메모 셋(회원·매니저, `rows=3`) | **16px** | 14 → **16** | **맞춰졌다** |
196
+ | 도움말 문의 내용(`rows=4`) | 16px | 14 → **16** | **맞춰졌다** |
197
+ | 반려 사유(어드민, `rows=3`) | 16px | 14 → **16** | **맞춰졌다** |
198
+ | **공지 상세**(어드민, `rows=4`) | **전부 14px** | 14 → **16** | **혼자 커졌다** |
199
+ | **FAQ 답변**(어드민, `rows=4`) | **전부 14px** | 14 → **16** | **혼자 커졌다** |
200
+
201
+ **가르는 것은 `rows` 가 아니다 — 곁의 조절칸이 몇이냐다.** 맞춰진 것과 어긋난 것이 둘 다
202
+ `rows=4` 다(말귀_3 실측, 폭 1440 · 빈 '추가'·'등록' 양식으로 재고 취소로 닫았다). 방문 창은
203
+ 곁의 값 칸이 이미 16 이라 메모만 14 로 **작았던** 것이고, 어드민 폼 둘은 곁이 전부 14 라
204
+ 여러 줄만 **커진** 것이다.
205
+
206
+ **아직 안 잰 넷** — 낱말 추가 창(`WordAddPopup`) · 코어 셋(`SaveTablePopup`·
207
+ `WordTableBlock`·`PanelRow` 갈래).
208
+
209
+ ### 뿌리는 여러 줄이 아니다 — **32 급에서 글자를 줄이는 것은 글상자뿐이다**
210
+
211
+ > **접혔다** — 같은 까닭. 다만 **이 표는 수와 무관하게 참이다**(32 급에 글자 규칙을 둔
212
+ > 조각은 `TextField` 하나이고, 줄이는 방식이 CSS·TSX·안 함으로 세 자리에 흩어져 있다).
213
+ > 누가 작은 급을 다시 꺼내는 날 이 표에서 시작하면 된다.
214
+
215
+ 말귀_1 이 찾고 말귀_3 이 맞댔고, 코어 소스에서 다시 세었다. **32 급에 글자 규칙을 둔
216
+ 조각은 `TextField` 하나다**(나머지 여섯은 없다). 그래서 한 줄 안에 급이 **셋**까지 선다:
217
+
218
+ | 조각 | 32 급에서 보이는 글자 | px(폭 ≥768) |
219
+ |---|---|---|
220
+ | **`TextField`** 치는 글자 | **`--s32` CSS 가 줄인다** | **14** |
221
+ | `Dropdown` 고르는 글자 | `body-2` — **안 줄인다** | **16** |
222
+ | `Tabs` · `DatePicker` | `body-2` — 안 줄인다 | 16 |
223
+ | `Button` 라벨 | size < 40 이면 `button-2`(TSX 가 고른다) | **13** |
224
+ | `SegmentedControl` | 속 단추를 따른다 | 13 |
225
+ | `Pagination` | `body-3` | 14 |
226
+
227
+ 말귀_3 실측(공지 '등록' 창 · 1440 · 빈 양식): 줄 이름표 14 · **치는 글자 넷 14** ·
228
+ **고르는 글자 셋 16**.
229
+
230
+ **그러니 여러 줄 칸은 증상이다.** 위 표의 세 꼴(방문 창 16·16 / 어드민 폼 14·16 / 낱말 추가
231
+ 창은 **한 판 안에 14 와 16 이 나란히**)은 전부 *그 판에 드롭다운이 많으냐 글상자가 많으냐*의
232
+ 그림자다. 말귀_3 이 낸 가름선(*"곁의 조절칸이 몇이냐"*)도 낱말 추가 창에서는 안 선다 —
233
+ 곁에 둘 다 있다.
234
+
235
+ **줄이는 방식도 조각마다 다르다** — `TextField` 는 **CSS 가 급별로**, `Button` 은 **TSX 가
236
+ `size < 40` 으로**, `Dropdown`·`Tabs`·`DatePicker` 는 **안 줄인다.** 한 자리에 모인 결정이
237
+ 아니라 세 자리에 흩어진 결정이고, 그래서 어긋난 것을 아무도 안 셌다.
238
+
239
+ **정할 것 하나 — `s32` 에서 글자 급을 어디에 맞추나.** 그 한 줄이 화면 전체의 무게를 바꾸니
240
+ 사장님 자리다. 말귀_3 이 방향을 받아 (409) 로 청하겠다고 적었다. 길 셋을 적어 두었던
241
+ ① `--textarea` 전용 중간 급 · ② 짧은 칸·긴 칸 가름 · ③ 이 한 줄 되돌리기 는 **셋 다 이
242
+ 뿌리를 안 건드린다** — ③ 으로 되돌려도 같은 판에서 치는 14 · 고르는 16 은 그대로다.
243
+
244
+ > 이 고침의 전제(*"박스가 작지 않으니 줄일 까닭이 없다"*)는 그대로 참이고, 여러 줄 칸
245
+ > 다섯이 곁과 맞아졌다. 다만 **그 다섯이 맞아진 까닭은 곁이 드롭다운이었기 때문**이고,
246
+ > 곁이 글상자인 둘에서는 혼자 커졌다. 글자 급은 박스가 아니라 **판 전체**가 정하는 것이라
247
+ > 규칙 한 줄로는 안 닫힌다.
248
+
249
+ **수를 박은 시험 둘이 이 고침을 막고 있었다** — `segmentedDefaultSize0921` 과
250
+ `segmentedSize24_0916` 이 *"안 주면 40"* 을 글자로 박아, 기본값을 내리자 빨개졌다.
251
+ 둘 다 `CONTROL_SIZE` 를 가져다 쓰게 고쳤다. 지키려는 뜻은 그대로다 — *"안 주고 쓴 자리가
252
+ 옆에 선 것과 같은 급으로 선다."*
253
+
254
+ `buttonSize` 기본값 셋은 **그대로 둔다**(`WordTable` 둘 · `SoundCompass`) — 표 안 단추는
255
+ 표 배율을 함께 받아 다른 결이고, 어드민은 그 둘을 안 쓴다.
256
+
257
+ ### (407) 묶음 띠 단추 32 — 말귀_3 청
258
+
259
+ > **되돌림 뒤**: 고칠 것이 남아 있지 않다 — **글자로 박힌 40 을 공용 수로 바꾼 것**이라,
260
+ > 수가 40 이 된 지금은 원래 모습 그대로다. `FilterPanel`·`WordSearchResultBlock` 도 같다.
261
+ > 다만 `FilterPanel` 의 **고르개 갈래는 32 를 손으로 적는 쪽으로 되돌렸다** — 그 자리의
262
+ > 닻은 공용 수가 아니라 옆 항목 단추(`size="keyboard"` 32)다.
263
+
264
+ `CONTROL_SIZE` 가 32 로 내려간 뒤에도 **`BulkBar` 의 단추 둘만 40 으로 남아 있었다.**
265
+ 묶음 띠는 표 위에 떠서 표 줄과 **같이 보이는** 자리라, 한 화면에 32 와 40 이 나란히 섰다.
266
+
267
+ **앱은 못 고치는 자리다** — `BulkBarProps` 에 `size` 가 없고, 코어가 `BulkAction` 으로
268
+ 할 일만 받아 크기는 스스로 적는다. 말귀_3 이 열어 달라고 하지 않고 **한 수로 서게**
269
+ 해 달라 청했다(손잡이를 열면 앱마다 다른 수를 넣어 틈이 다시 열린다).
270
+
271
+ 말귀_3 실측(어드민 · 폭 1024 · 열두 쪽을 쓸어 조작칸 키를 셈) — **40 은 묶음 띠에서만**:
272
+
273
+ | 쪽 | 32 | 40 |
274
+ |---|---|---|
275
+ | 이용권 › 쿠폰 | 36 | **4** |
276
+ | 버그 · 보안 · 로그 | 20 | **4** |
277
+ | 나머지 열 쪽 | 전부 32 | 0 |
278
+
279
+ **같이 고친 자리 둘** — 둘 다 같은 줄에서 눈에 보이던 어긋남이다:
280
+
281
+ - `FilterPanel` — 머리 접기 단추(40), 그리고 절 드롭다운(40). 바로 위 `SegmentedControl`
282
+ 갈래는 2026-09-22 에 이미 32 로 내려가 있어, **한 절 안에서 갈래에 따라 키가 달랐다.**
283
+ - `WordSearchResultBlock` — 툴바 드롭다운 둘(40). 바로 옆 `Pagination` 이 32 다.
284
+
285
+ `SummaryStrip` 의 보기 글과 `controlSize.ts` 머리말에 **옛 수 40 이 적혀** 있던 것도
286
+ 함께 내렸다(글에 적힌 수는 조용히 낡는다 — 말귀_3 도 오늘 그것을 한 번 밟았다).
287
+
288
+ **왜 지난 그물에 안 걸렸나.** `controlSize1029` 시험은 **고른 다섯 파일**만, 그 안에서도
289
+ `Dropdown`·`SegmentedControl`·`TextField` 만 봤다. `BulkBar` 는 목록에 없고 크기를 든 것이
290
+ `Button` 이라 **두 그물에 다 안 걸렸다.** 목록을 늘리는 것으로는 또 빠지므로,
291
+ **`src` 전체에서 40 을 세어 수를 박았다**(지금 21파일 37자리 — 줄·머리가 아니라서
292
+ 남은 것들이다). 새로 적으면 시험이 울고, 그 자리가 줄·머리인지 정하게 된다.
293
+
294
+ **허용 목록을 늘리지 않고 없앴다.** 내 '다섯 파일' 목록이 `BulkBar` 를 놓친 것과,
295
+ 말귀_3 의 '다섯 태그' 목록이 하루에 세 번 눈먼 것이 **같은 병**이다 — 허용 목록은
296
+ *새로 생긴 것이 기본으로 안 세어지는* 쪽이라 늘려도 또 빠진다. 이제 `size` 꼴 이름을
297
+ **다 모으고**, 조작칸 키가 아닌 것만 까닭과 함께 적는다. **둘 중 어디에도 없는 이름이
298
+ 나오면 빨개진다.**
299
+
300
+ **이름을 뜻으로 가른다**(말귀_3 이 돌려준 것). 어드민에 `pageSize` 가 일곱 있었다 —
301
+ 쪽 크기 고르개(10·20·50)라 키와 무관한데, *"이름이 size 로 끝나고 40 이 있으면 센다"* 로
302
+ 두면 **쪽 크기로 40 을 고르는 날 멀쩡한 줄을 고치라고 한다.** 코어에도 `pageSize`·
303
+ `fontSize`·`iconSize`·`backgroundSize`·`printSize`·`onResize` 가 있다.
304
+
305
+ **네 꼴을 다 본다** — `size={40}` · `size: 40`(꾸러미 칸) · `btnSize`(이름이 `size` 가
306
+ 아니라 영영 안 걸린다) · `size = 40`(비구조화 기본값) · `size={a ? 40 : 48}`(식).
307
+
308
+ **넓히다 둘이 더 나왔다.**
309
+
310
+ - `TrainingWordCard` 의 `size={isMobile ? 40 : 48}` — **그대로 둔다.** 폰에서 점단추(40)·
311
+ 넓은 화면에서 글자 있는 막대단추(48)로 **꼴 자체가 바뀌는** 자리고 `type` 과 `label` 도
312
+ 함께 갈린다. 2026-10-29 에 걷은 '같은 단추가 조용히 줄어드는 사다리' 와 다른 것이다.
313
+ - **기본값 넷이 아직 40 이다** — `TextField` · `SegmentedControl` · `Tabs` · `ColorPicker`.
314
+ 코어가 줄·머리를 지을 때는 `CONTROL_SIZE` 를 손에 넘기므로 **지금 눈에 보이는 흠은
315
+ 없지만**, `size` 를 안 주고 부르면 40 이 선다(2026-11-02 에 32 를 깐 것은 `Dropdown`·
316
+ `DatePicker` 둘이다). `buttonSize` 기본값도 셋이 40 이다(`WordTable` 둘 · `SoundCompass`).
317
+ **내릴지는 정할 일이라 이 판에서는 안 건드리고 수만 지킨다.**
318
+
319
+ ### 그룹 머리의 단추가 그룹 밖으로 밀려나 잘렸다 — 말귀_2 청 (364)
320
+
321
+ `.training-card-group__header` 가 `height: 60px` **고정**이고 단추 줄이 `flex-shrink: 0`
322
+ 이라, 들어갈 자리가 없으면 단추가 그룹 밖으로 밀려났다. `.training-card-group` 이
323
+ `overflow: hidden` 이라 **밀어서 볼 수도 없었다.**
324
+
325
+ 말귀_2 실측(매니저 '나의 단어훈련' · 폭 375 · 0.414.0): 머리 333px 에 단추 줄 **360px**
326
+ (`40·40·40·120·40·40` + 사이 `8×5`)이라 '그룹 삭제' 가 12px, '이 그룹에 훈련 추가' 가
327
+ **60px — 통째로** 안 보였다.
328
+
329
+ **`flex-shrink: 0` 이 진짜로 막던 것이다.** 말귀_2 가 레버를 여덟 꽂았다 뺐는데 **하나도
330
+ 안 들었던**(전부 60 그대로) 까닭이 이것이다 — 줄어드는 것 자체가 막혀 있으면 `min-width: 0`
331
+ 도 `flex-wrap` 도 할 일이 없다.
332
+
333
+ **청해 온 두 줄로는 안 됐다.** 그 꼴(`__header{min-width:0}` + `__actions{min-width:0;
334
+ flex:1 1 auto;flex-wrap:wrap}`)을 브라우저에서 재 보니 가로 넘침은 0 이 되는데 **단추 셋이
335
+ 머리 아래로 내려가 본문을 덮었다** — 머리가 60px 고정이라 줄바꿈한 둘째 줄이 설 자리가
336
+ 없다. **가로만 재면 '다 들어왔다' 로 보인다.** 그래서 머리도 커질 수 있게 했다.
337
+
338
+ | | 그룹 밖 단추 | 머리 키 |
339
+ |---|---|---|
340
+ | 통375 · 단추6 · 전 | **2** | 60 |
341
+ | 통375 · 단추6 · 후 | **0** | 156 |
342
+ | 통375 · 정렬만 · 전/후 | 0 / 0 | 60 / **60** |
343
+ | 넓은 통 · 정렬만 · 전/후 | 0 / 0 | 60 / **60** |
344
+
345
+ **자리가 넉넉하면 전과 똑같다** — `min-height: 60px` + 위아래 여백 10px 이고 단추가 40px
346
+ 이라 한 줄이면 그대로 60 이다. 놀이터에 그 꼴을 세웠다(`#training-card` · '좁은 통 ·
347
+ 단추 여섯').
348
+
349
+
350
+
351
+ ### 긴 제목이 쪽 전체를 옆으로 밀었다 — 말귀_2 청 (363)
352
+
353
+ 폰에서 도움말 쪽이 **손가락으로 옆으로 밀렸다.** `.accordion-item__title` 은 `flex: 1` 로
354
+ 늘어나는 칸인데, 플렉스 자식의 `min-width` 는 기본이 **`auto`** 라 속 내용의 최소 폭
355
+ 아래로 안 줄어든다. 제목 안에 한 줄 + 말줄임(`white-space: nowrap`)인 미리보기를 넣으면
356
+ **그 줄의 최소 폭이 칸의 바닥**이 되고, 칸이 머리를 넓히고 머리가 쪽을 넓힌다.
357
+
358
+ 앱은 제 쪽 `.help-inquiry-item__head` 에 `min-width: 0` 을 이미 주고 있었는데 **코어 칸에서
359
+ 막혀** 안 내려왔고, 못 `coreOwnedCssTargets` 가 앱 CSS 로 코어 이름 겨누는 것을 막으므로
360
+ 앱에서 덮을 길도 없었다. 그래서 코어가 고친다 — `min-width: 0` 한 줄이다.
361
+
362
+ 말귀_2 실측(회원앱 `/help` · 폭 375 · 0.413.0, 꽂았다 뺐다 두 번):
363
+
364
+ | | `.content-area` 의 `scrollWidth` | 그 줄의 폭 |
365
+ |---|---|---|
366
+ | 전 | **454** (칸은 375 — 79px 이 밖으로) | 381px · 41 → 422 |
367
+ | 후 | **375** (넘침 0) | 261px · 41 → 302 |
368
+
369
+ **아무것도 안 가린다.** 이것은 *줄어들 수 있게* 할 뿐이고, 자르는 것은 제목 안에 넣은 글이
370
+ 스스로 정하는 일이다. 코어는 칸이 쪽을 밀지 않게만 한다.
371
+
372
+ **넓은 창은 안 흔들린다.** 놀이터 아코디언 쪽의 제목 칸 **열셋**을 1440 과 375 에서 재고
373
+ 고침을 넣었다 뺐다 했다 — 달라지는 것은 **긴 미리보기가 든 그 한 칸뿐**이고(246 ↔ 396,
374
+ 396 은 그 줄의 본디 폭이다) 나머지 **12/13 은 글자까지 같다.** 되돌리면 396, 다시 넣으면
375
+ 246 으로 두 번 오갔다.
376
+
377
+ 놀이터에 그 꼴을 세웠다(`#accordion` · '긴 제목이 쪽을 옆으로 밀지 않는다'). 다만 **쪽
378
+ 수준 넘침은 놀이터에서 안 재진다** — 보기 상자가 `overflow-x: hidden` 으로 삼킨다. 쪽까지
379
+ 가는지는 소비자의 조상에 달렸고 그쪽은 말귀_2 가 앱에서 쟀다.
380
+
381
+ `.accordion-item__title` 말고도 **늘어나면서 `min-width` 를 안 적은 규칙이 코어에 32개**
382
+ 더 있다. 일괄로는 안 고쳤다 — `min-width: auto` 가 **맞는** 자리(줄어들면 안 되는 이름표
383
+ 따위)가 섞여 있어, 어느 것이 진짜 결함인지는 재야만 갈린다.
384
+
385
+ ### 세로줄 이름표가 가로줄의 폭을 높이로 입고 있었다 — 줄마다 42px
386
+
387
+ `align="vertical"` 줄에서 이름표 글자는 22px 인데 이름표 칸이 **64px** 로 섰다. 가로줄의
388
+ 이름표 *폭*을 잡는 `flex: 0 0 var(--panel-label-width, 120px)` 이, `flex-direction: column`
389
+ 인 세로줄에서는 **높이**가 되기 때문이다.
390
+
391
+ **되돌림은 처음부터 있었다 — 세기가 모자랐다.** `.panel-row--vertical .panel-row__left
392
+ { flex: none }` 이 (0,2,0) 인데, `:has()` 가 가장 센 인자의 특이도를 물려받아 저쪽이
393
+ (0,4,0) 이었다. 값이 아니라 **특이도**를 맞춰 다시 적었다.
394
+
395
+ 말귀 실측(단어표 만들기 · 폭 1,766):
396
+
397
+ | | 전 | 후 |
398
+ |---|---|---|
399
+ | 이름 줄 | 128px | **86px** |
400
+ | 설명 줄 | 162px | **120px** |
401
+ | 이름표 칸 키 | 64px | **22px**(글자 키) |
402
+
403
+ ### `refitOn` 설명에 '늦게 오는 칸 내용' 을 적는다 — 동작은 안 바뀐다
404
+
405
+ 말귀 '단어 관리' 가 넷에 한 번 뜻 없는 폭(320px)으로 굳는 것을 겪었다. 까닭은 타이밍이
406
+ 아니라 **걸쇠**다 — `refitBasis` 에 `loading` 도 `items` 도 안 드니, 줄은 들어왔는데 칸
407
+ 글자가 아직 빈 렌더가 한 번이라도 서면 그 폭이 박혀 안 풀린다. `loading` 으로 막는 것은
408
+ 한 발이고, 걸쇠를 다시 여는 것은 `refitOn` 뿐이다. 그 쓸 자리가 설명에 없어 말귀가 겹옷
409
+ 셋을 세워야 했으므로, 한 단락 적었다(실측 3/4 ↔ 4/4 포함).
410
+
411
+ 그 주석이 제 못을 울렸다 — `tableRefitOn1031` 이 소스를 **주석까지** 읽고 있었다. 주석을
412
+ 걷게 했다. 거꾸로도 틀려 있었다(`toContain` 들은 prop 을 빼도 옛 설명이 그 글자를 들고
413
+ 있으면 초록이 된다).
414
+
415
+ ## 0.413.0 — 머리말을 눌러도 안 세워지던 열을 세운다 · 문턱 430 · 그림 압축 한 벌
416
+
417
+ ### 머리말을 눌러도 안 세워지는 열이 있었다 (사장님 지시)
418
+
419
+ *"table field 에서 컬럼이름 누르는데 sort 기능이 안되는 곳이 있네? 말귀매니저의 단어관리의
420
+ 제외, 단어, 이미지 컬럼이야."*
421
+
422
+ 정렬은 머리말에 적힌 대로 **기본으로 켜져** 있다. 값은 `sortValue` → `sortKey` → **칸에
423
+ 그려진 값** 차례로 찾는데, 마지막 길이 `string`·`number` 일 때만 열렸다. 그래서 글자를
424
+ 마디 하나에 싸 넣은 열이 **조용히** 빠졌다 — `<span className="body-2b">{w.word}</span>`
425
+ 가 그 꼴이고, 그것이 `단어` 열이었다.
426
+
427
+ | 열 | 칸에 든 것 | 전 | 후 |
428
+ |---|---|---|---|
429
+ | `단어` | `<span>{word}</span>` | 안 세워짐 | **세워짐** |
430
+ | `제외` | `<Checkbox checked>` | 안 세워짐 (조용히) | 안 세워짐 + **알림** |
431
+ | `이미지` | 썸네일 | 안 세워짐 (조용히) | 안 세워짐 + **알림** |
432
+
433
+ **① 마디에 싸인 글자를 꺼낸다.** 깊이가 달라도 같은 값으로 본다 — 말귀는 한 열에
434
+ `<span>{word}</span>` 와 `<span><button>{word}</button></span>` 가 섞여 있다(더한 낱말은
435
+ 눌러서 고친다).
436
+
437
+ **`aria-label` 은 안 본다.** `Checkbox` 의 `ariaLabel` 은 줄마다 **같은 글자**라, 그것으로
438
+ 세우면 화살표는 도는데 줄은 그대로다. 못 세우는 것보다 나쁘다 — 눌러 보고 세워졌다고
439
+ 믿게 된다.
440
+
441
+ **② 글자가 아예 없는 칸은 조용히 빼지 않고 알린다.** 무엇으로 세울지는 코어가 알 수 없다
442
+ (네모면 켜짐 순? 그림이면 있음 순?). 개발 모드에서 한 번 찍는다:
443
+
444
+ ```
445
+ [ihab/Table] 정렬에서 빠진 열이 있습니다: '제외' · '이미지'
446
+ 칸에 글자가 없어(네모·그림·단추 같은 마디) 무엇으로 세울지 알 수 없습니다.
447
+ 그 열의 `sortValue` 를 주세요 — 예: `sortValue: (w) => !!w.image`.
448
+ 일부러 안 세우는 열이면 `sortable: false` 를 적으면 이 알림이 멎습니다.
449
+ ```
450
+
451
+ 운영 빌드에서는 아무 일도 하지 않는다. **빠진 것을 눌러 봐야 알던 것**이 이제 콘솔에서
452
+ 먼저 보인다 — 사장님이 찾으신 길이 그 눌러 보는 길이었다.
453
+
454
+ **옛 시험 하나를 바로잡았다.** `tableFieldWidthAlignSort` 가 *"마디 칸인데 정렬이 붙었다"*
455
+ 를 흠으로 적고 있었다. 적힌 까닭은 *"눌러도 아무 일 없을 화살표를 안 띄운다"* 였는데,
456
+ `<span>{score}</span>` 는 눌러도 아무 일 없는 칸이 **아니다.** 못 읽음을 시험이 지키고
457
+ 있었다. 뜻을 다시 적었다 — **글자가 있으면 세우고, 아예 없으면 안 세운다.**
458
+
459
+ ### 격자가 저절로 만든 빈 칸에도 `+` 가 선다 — 청 (362)
460
+
461
+ 사장님 *"wordcell이 비어있을때 커스텀 단어를 넣고 싶다"*. 말귀가 `onAddItem` 으로 창을
462
+ 띄웠는데 **그 `+` 가 낱말이 하나도 없을 때만 섰다.**
463
+
464
+ 빈 칸은 `itemCols * itemRows − 낱말수` 로 센다 — 낱말 일곱이면 격자가 4×2 라 빈 칸
465
+ 하나가 선다. **그 칸은 그려지고 있었다.** 그런데 문이 이랬다:
466
+
467
+ ```
468
+ const isWithinCount = 낱말수 + i < (addableCount ?? cellCount)
469
+ ```
470
+
471
+ `cellCount` 는 `count ?? dataLen` 이라 **칸 수를 따로 주지 않은 표에서는 곧 낱말수**다.
472
+ `낱말수 + i < 낱말수` 는 `i = 0` 에서도 거짓이라 **`+` 가 영원히 안 섰다.**
473
+
474
+ **붙어 있던 두 길로는 안 됐다**(말귀가 세어 올렸다):
475
+
476
+ | 주는 것 | 왜 안 되나 |
477
+ |---|---|
478
+ | `cellCapacity={12}` | `capacity → itemsPerPage → count → gridFor(count)` 라 **일곱 낱말짜리 표가 열두 칸**으로 그려진다(종이에 찍히는 것이 바뀐다) |
479
+ | `showCellCount` | `pagesEnabled = !isEditable && !showCellCount` 라 **쪽 나누기가 꺼진다** |
480
+
481
+ **새 prop 을 두지 않았다.** 여기 서는 칸은 이미 격자의 빈 칸뿐이라, 칸 수를 안 준 표에서는
482
+ **셀 것이 없다** — 그려진 빈 칸이 곧 채울 수 있는 칸이다. 표는
483
+ `addableCount ?? 격자 칸 수` 를 쓰고, **조이는 수는 `addableCount` 로만 받는다.**
484
+
485
+ **가름이 어느 층에 있어야 하는가 — 한 번 틀렸다.** 처음에는 표에서 *"`count` 를 일부러
486
+ 줬나"* 로 갈랐다. **그게 아니다**(말귀가 fiber 의 props 를 읽어 잡았다):
487
+ `WordTableBlock` 이 `count={itemsPerPage}` 를 **늘 넘기므로**(388·488·532줄) 블록을 쓰는
488
+ 소비자는 영영 '줬다' 쪽이고, 새 길은 `WordTable` 을 **직접** 쓰는 자리에서만 열렸다.
489
+ 쪽 나눈 가지는 한 겹 더 있었다 — 거기서는 블록이 `addableCount` 를 직접 넘기는데 그 수가
490
+ `capacity − i*쪽당` 이고, 칸 수를 안 주면 `capacity` 가 곧 낱말 수라 역시 안 열렸다.
491
+
492
+ *"소비자가 칸 수를 일부러 정했나"* 를 아는 것은 **블록**이다 — `cellCapacity` 와
493
+ `showCellCount` 뿐이고, 블록이 제 셈으로 채우는 `itemsPerPage`·`count` 는 아니다. 그래서
494
+ 가름을 블록으로 올렸다(`capacitySet`). 정했을 때만 `addableCount` 를 내려 주고, 안 정했으면
495
+ 안 넘겨 표가 제 격자 칸 수를 쓴다.
496
+
497
+ **정한 표에서는 그 수를 지킨다** — `cellCapacity={5}` 면 여섯 칸 격자에 빈 칸이 셋이어도
498
+ 채울 수 있는 것은 둘이다. 내려 주는 수는 **`capacity` 가 아니라 `count`** 다:
499
+ `showCellCount` 모드에서 사람이 고른 칸 수는 `count` 에 담기고 `capacity` 는 그것을 모른다
500
+ (`capacity` 를 넘겼더니 '2칸' 을 고른 한 낱말 표에서 추가하기가 사라졌다 — 기존 시험이
501
+ 잡았다).
502
+
503
+ **`WordTableBlock` 의 개발 경고를 걷었다** — *"표시 모드에서 `onAddItem` 은 `cellCapacity`
504
+ 나 `showCellCount` 와 함께 줘야 한다"*. 그 글의 전제(*"빈 칸은 `showCellCount` 로 늘릴
505
+ 때만 생긴다"*)가 **틀렸다.** 이제 함께 줄 것이 없다.
506
+
507
+ 못은 **두 층에** 둔다. `test/wordTableFillerAdd1031.test.tsx`(다섯 벌)가 `WordTable` 을,
508
+ `test/wordTableBlockFillerAdd1031.test.tsx`(네 벌)가 **소비자가 쓰는 꼴 그대로**
509
+ `WordTableBlock` 을 센다 — 첫 고침이 표만 재서 초록이었고 앱에서는 안 섰다. 격자 나머지가
510
+ **많아도 둘**이라(`LAYOUTS` 를 읽어 확인했다) 열셋으로 둘을 세우고, 꽉 찬 격자에 `+` 가 안
511
+ 서는 반대쪽도 센다. 네 가지로 깨 보고 넷 다 붉어졌다.
512
+
513
+ **옛 시험 하나를 바로잡았다.** `wordTableBlockCellCapacity1028` 이 *"안 주면 빈 칸이 없다"*
514
+ 로 `추가하기` 가 **0** 이라고 셌다. 그 전제가 틀렸다 — `gridFor(11)` 은 4×3, 즉 **열두 칸**
515
+ 이라 낱말 열하나면 빈 칸이 하나 있다. 그 칸은 그려지고 있었고 `+` 만 안 섰다. 못 읽음이
516
+ 아니라 **못 섬을 시험이 지키고 있었다.**
517
+
518
+ ### '칸 너비 초기화' 가 처음 모습으로 돌아온다 — 청 (361)
519
+
520
+ 사장님 *"칸 너비 초기화가 정상적으로 동작을 못하네"*. 말귀 '단어 관리' 표(아홉 칸)에서
521
+ 초기화를 누르면 **한 번도 본 적 없는 셋째 모습**이 섰다 — `0.9fr` 셋이 전부 `minmax`
522
+ 바닥으로 주저앉고 남은 자리를 마지막 칸이 혼자 먹었다.
523
+
524
+ **까닭은 맞추는 식에 자유가 없었던 것이다.** `fitFluidWidths` 는 잰 값을 그릇에 맞게
525
+ 비율로 줄이는데, **바닥 합이 이미 쓸 수 있는 폭보다 넓으면** `Math.max(floorOf(i), …)`
526
+ 에서 전부 바닥으로 떨어진다. 넘치는 것은 그대로인데 비율만 잃으니 **더 나쁜 꼴**이다.
527
+
528
+ 코어 놀이터에서 그대로 재현했다(통 778 · 일곱 칸 `minmax(260px,2fr) minmax(150px,0.8fr) …`):
529
+
530
+ | | 격자 | 합 |
531
+ |---|---|---|
532
+ | 처음 모습(선언된 틀) | `311 150 156 156 140 171 156` | 1240 |
533
+ | 초기화 뒤 (전) | **`260 150 150 150 120 150 150`** | 1130 |
534
+ | 초기화 뒤 (후) | `311 150 156 156 140 171 156` | **1240** |
535
+
536
+ 바닥 합 1130 이 쓸 수 있는 폭 738 보다 넓어 식에 자유가 없었다. 그리고 **갇혔다** —
537
+ 세 번 더 눌러도 같은 값이었다(한 번 픽셀로 굳으면 다시 재도 같은 바닥이 나온다).
538
+
539
+ **고침: 자유가 없으면 아무것도 쓰지 않는다.** `fitHasNoFreedom` 이 가름하고, 그때
540
+ `measureAutoWidths` 가 `DECLARED` 를 돌려준다 — `colWidths` 가 안 서고 선언된 틀이 그대로
541
+ 선다. 브라우저가 `fr` 로 비율을 나눠 주므로 **처음 연 모습과 글자까지 같다.** 청 (361) 이
542
+ 바란 ①이 그것이다.
543
+
544
+ **맞출 수 있는 표는 한 자도 안 바뀐다.** 놀이터 표 넷을 눌러 확인했다(통 1087) — 넷 다
545
+ 전처럼 재서 픽셀로 서고 합이 1047 로 통을 채운다.
546
+
547
+ 이 고침이 `refitOn` 의 톱니도 함께 없앤다. 말귀 실측으로 쪽을 빠르게 되돌리면 같은 꼴로
548
+ 주저앉아 **1쪽↔2쪽을 2.5초씩 네 번 오가도 다섯 번 다 같은 값**이었고 새로고침해야
549
+ 돌아왔다 — 재는 대신 틀로 되돌리니 그 길이 없어진다.
550
+
551
+ 규칙은 `tableFitWidths.ts` 가 든다(순수 함수라 셀 수 있다).
552
+ `test/tableResetKeepsTemplate1031.test.ts` 가 다섯 벌로 센다 — 네 가지로 깨 보고 넷 다
553
+ 붉어졌다.
554
+
555
+ ### 쪽을 넘기면 자동 모드의 표가 다시 잰다 — `refitOn` (사장님 지시)
556
+
557
+ *"칸 너비 초기화가 true 면 페이지가 넘어가면 활성화 해주도록"*
558
+
559
+ 2026-10-13 에 **"줄이 갈릴 때마다 다시 재기" 를 계기에서 뺐다** — 저장 열쇠가 있는 표
560
+ 스물여덟 중 **열아홉**이 찾는 칸이나 쪽 나누기를 갖고 있어, 치는 동안·쪽을 넘길 때마다
561
+ 칸이 움직였기 때문이다. **그 결정은 그대로 두고 고르는 길만 열었다.**
562
+
563
+ `refitOn` 에 쪽 번호를 주면 그 값이 바뀔 때마다 다시 잰다. 안 주면 `''` 이라 지문이 안
564
+ 흔들려 **전과 똑같다**(기본은 안 준다).
565
+
566
+ 말귀 '단어 관리' 가 이 자리를 짚었다 — 23,000줄을 스물다섯씩 넘겨 보는 표라 **첫 쪽의
567
+ 짧은 낱말로 잰 폭이 다음 쪽의 긴 낱말에 안 맞는 일이 잦다.** 거기서는 칸이 움직이는 값보다
568
+ **글자가 접히는 값**이 크다. 둘은 같은 표에서도 갈리므로 고르게 두었다.
569
+
570
+ **손으로 끌어 둔 표에는 안 듣는다**(`manual`) — 사람이 정한 폭을 쪽 넘김이 덮으면 그것이
571
+ 더 뜻 모를 움직임이다. '칸 너비 초기화' 를 눌러 자동으로 돌아가면 다시 듣는다.
572
+
573
+ 그리는 것은 jsdom 에서 못 센다(`getBoundingClientRect` 가 전부 0 이다). 그래서
574
+ `test/tableRefitOn1031.test.tsx` 는 **배선**을 센다 — 지문에 드는지 · 안 주면 안 흔들리는지 ·
575
+ 손으로 끈 표를 안 건드리는지. 두 가지로 깨 보고 둘 다 붉어졌다.
576
+
577
+ ### 통이 좁아져 자유를 잃은 표가 넓던 때 잰 폭을 쥐고 있었다 — 청 (361)②
578
+
579
+ 사장님 *"그 표 세워서 ② 잡아"*. 말귀가 *"쪽을 되돌리면 한 번 가라앉고 안 돌아온다"* 로
580
+ 적어 올린 자리다.
581
+
582
+ **세워 재지 못하고 있었다.** 이 저장소에는 **저장 열쇠 · 자동 맞춤 · 쪽 나누기 ·
583
+ `refitOn` 넷을 함께 가진 표**가 한 자리도 없었다 — 폭 조절 보기에는 쪽이 없고, 쪽 나누기
584
+ 보기에는 저장 열쇠가 없다. 그래서 놀이터 `#table` 에 **아홉 칸 표**를 세웠다(말귀
585
+ '단어 관리' 와 같은 조합: 못 박은 px 다섯 `48·64·90·96·84` = 382, `minmax` 넷 바닥
586
+ `160·140·140·180` = 620, 63줄을 열씩, 쪽마다 낱말이 길어진다).
587
+
588
+ **가름하는 수는 쪽과 무관하다.** 바닥 합과 고정 px 합은 **선언된 틀**에서 오고, 쪽마다
589
+ 달라지는 것은 잰 글자 폭뿐이다. 그래서 문턱은 `620 + 382 = 1002` 한 수고, 그릇이 그보다
590
+ 넓으면 어느 쪽에서도 자유가 있다. 재어 확인했다 — 그릇 1281 과 1011 에서 1쪽→7쪽→1쪽을
591
+ 오가니 **되돌아온 값이 글자까지 같았다.** 쪽 넘김 자체에는 흠이 없었다.
592
+
593
+ **흠은 15px 이었다.** 그릇을 1010 에서 995 로 — 세로 스크롤바 한 자리만큼 — 좁히니:
594
+
595
+ | 때 | 그릇 | 격자 | 합 | 넘침 |
596
+ |---|---|---|---|---|
597
+ | 1쪽 | 1010 | `48 162 64 142 142 90 96 84 182` | 1010 | 0 |
598
+ | 15px 좁힘 | 995 | **그대로** | 1010 | 15 |
599
+ | 그 상태로 2쪽 | 995 | **그대로** | 1010 | **55** |
600
+ | 초기화 누름 | 995 | `48 215 64 140 140 90 96 84 245` | 1122 | 127 |
601
+ | 그 뒤 쪽 넘김 | 995 | 안 돌아온다 | | |
602
+
603
+ **한 값이 두 뜻을 지고 있었다.** `measureAutoWidths` 가 *"잴 수 없다"*(마디가 없다 · 잴
604
+ 줄이 없다)와 *"맞출 자유가 없다"* 를 똑같이 `null` 로 돌려주어, 부르는 쪽이 가를 수
605
+ 없었다. 쥔 폭을 그대로 두는 것이 앞쪽에는 **맞고**(걸러서 0건이 되었다 돌아오는 자리),
606
+ 뒤쪽에는 **틀렸다** — 넓던 때 잰 폭이 좁아진 그릇에 남아 2쪽에서 글자가 트랙을 55px
607
+ 넘쳤다. 그러고는 초기화를 누르는 순간에야 선언된 틀로 **한 번 뛰어** 떨어졌고, 그 뒤로는
608
+ 쪽을 넘겨도 돌아오지 않았다. 말귀가 ②로 적어 올린 모습이 그것이다.
609
+
610
+ **고침: 두 뜻을 가른다.** 자유가 없을 때는 `DECLARED` 를 돌려주고, 부르는 쪽이 쥔 폭을
611
+ **비운다** — 초기화 단추가 하던 일과 **같은 일**이고, 같은 규칙이 두 길에서 같은 모습을
612
+ 내게 된다. *"잴 수 없다"* 는 전과 같이 쥔 폭을 그대로 둔다.
613
+
614
+ 밀려서 보는 것이 잘려 안 보이는 것보다 낫다 — 틀로 떨어지면 가로로 더 스크롤하지만
615
+ (127 > 15) 어느 칸도 제 바닥 아래로 깎이지 않는다. 저장소가 적어 둔 그 결 그대로다.
616
+
617
+ 브라우저에서 고친 뒤를 다시 쟀다 — 좁히고 쪽을 넘기면 **틀로 떨어지고**, 다시 넓히면
618
+ **또 잰다**(그릇 1078 · 합 1078 · 넘침 0). 갇히지 않는다.
619
+
620
+ `test/tableRefitLosesFreedom1031.test.tsx` 가 다섯 벌로 센다. 깨 보니 *"통이 좁아지면 틀로
621
+ 떨어진다"* 가 `444px 556px` 를 쥔 채 붉어졌다 — 넓은 그릇에서 잰 그 값이다.
622
+
623
+ 놀이터 `#table` 에 그 표를 남겨 둔다(`refitOn · resizeStorageKey · useTablePaging`) —
624
+ 다음에 이 자리를 재야 할 때 다시 세우지 않아도 된다.
625
+
626
+ ### 쌓는 문턱 480 → 440 → **430** (사장님 지시 두 번)
627
+
628
+ `small` 창(480)의 판이 **440** 이라 `@container (min-width: 480px)` 되돌리기에 한 번도
629
+ 안 걸렸다 — `small` 창은 늘 쌓였다. 먼저 440 으로 내렸는데, **여유가 0px 이고 테두리에
630
+ 걸렸다.**
631
+
632
+ 담는 그릇은 **속상자**를 잰다(`container-type: inline-size`). 판에는 테두리가 1px 씩
633
+ 있으므로 겉폭 440 인 판의 속폭은 **438** 이다 — 문턱 440 에는 **안 걸린다.**
634
+
635
+ | 겉폭 440 | 속폭 | 문턱 440 | **문턱 430** |
636
+ |---|---|---|---|
637
+ | 테두리 있음 (`.panel`) | **438** | 쌓인다 ✗ | **가로** |
638
+ | 테두리 없음 (`--no-border`) | 440 | 가로(딱 걸침) | **가로** |
639
+
640
+ 말귀의 `FormPanel` 은 `useBorder={false}` 라 440 에서도 뜻대로 섰지만, `popup--small`
641
+ 에서 테두리를 안 끈 `<Panel>` 이 셋 있었다(`UserSubListPopup` · `UserPayListPopup` ·
642
+ `UserDetailConfirmPopups`) — **그 셋은 440 에서도 쌓였다.** 그래서 **430** 으로 내렸다.
643
+ 테두리 있는 판에 8px, 없는 판에 10px 여유가 생긴다(실측: 테두리 있는 판이 겉폭 **433**
644
+ 까지 가로로 선다).
645
+
646
+ **잰 값은 그대로 넘는다 — 넘침은 어느 폭에서도 0 이다.** `--fill` 줄은 넘치지 않고 **칸이
647
+ 줄고**, `children` 줄은 칸이 170px 을 지키고 **라벨이 준다**:
648
+
649
+ | | 판 480 | 판 440 | 판 430 |
650
+ |---|---|---|---|
651
+ | 라벨 110 · `--fill` 칸 | 354 | 314 | 304 |
652
+ | 라벨 200 · `--fill` 칸 | 264 | 224 | 214 |
653
+
654
+ 그래서 이 문턱은 *"넘치는가"* 가 아니라 **"칸을 얼마나 좁게 두고 볼 것인가"** 를 정하는
655
+ 수다. 라벨 200 에 칸 214px 이면 선다. 바뀌는 띠는 **판 430~439** 뿐이다.
656
+
657
+ ### 그림을 가볍게 하는 한 벌 (`utils/imageCompression`)
658
+
659
+ 올릴 때 줄이고(`compressImageFile` — 긴 변 720 · webp · 품질 0.8) 받을 때 줄여 받는다
660
+ (`imageTransformUrl` — `/object/public/` → `/render/image/public/`). 두 앱이 **같은 수**를
661
+ 보도록 잣대도 함께 내보낸다(`imageCompressionPolicy` · `imageViewWidth` ·
662
+ `imageTransformQuality` · `fittedSize` · `canCompressImageType` · `renamedForType`).
663
+
664
+ 움직이는 GIF 는 건드리지 않는다 — 캔버스로 그리면 첫 장만 남는다. 저장소 밖 주소
665
+ (`blob:` 따위)는 **그대로 돌려주므로** 부르는 쪽이 먼저 따질 필요가 없다.
666
+ 쓰는 법은 놀이터 `app-setup` 쪽에 적었다.
667
+
668
+ ### 소비자 표를 실측으로 되돌렸다
669
+
670
+ 소리방향성·kscan 두 줄이 `^0.211.0` 으로 적혀 있었는데 실물은 `0.349.0` 과 `^0.338.0`
671
+ 이었다. `audit:consumers` 가 저장소를 직접 읽어 잡았다.
672
+
10
673
  ## 0.412.0 — 0.410.0 이 좁은 판에서 **넘침을 만들었다**. 고친다
11
674
 
12
675
  **0.410.0 의 결함을 고치는 판이다.** 말귀가 좁힌 판에서 줄이 안 쌓이는 것을 보고 물어 와