@ihabdevteam/core 0.370.0 → 0.372.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 CHANGED
@@ -7,6 +7,169 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.372.0 — `WordTable` 에 **절반을 쓰는 머리 칸**(`baseItem`)
11
+
12
+ ### 활용표를 위한 머리 칸
13
+
14
+ 사장님 말씀(2026-10-27): *"wordtable 에서 가로일때 좌측 반, 세로일때 상단 반 을 기본형으로
15
+ wordcell 사용해서 표현하는것만 수정하면 그대로 쓸수 있을거 같은데?"*
16
+
17
+ **활용표**(한 낱말의 여러 꼴 — `감사하다` → `감사해요 · 감사합니다 · 감사했다 …`)를 위한
18
+ 자리다. 모든 칸이 **같은 낱말**이라 그냥 그리면 같은 그림이 칸마다 되풀이된다(말귀 실측:
19
+ 여덟 칸에 같은 그림 여덟 장). 그림을 머리 칸에만 두고 나머지는 글자만 세운다.
20
+
21
+ ```tsx
22
+ <WordTable
23
+ items={conjugations}
24
+ baseItem={baseWord}
25
+ baseContentTypes={['image', 'word']} /* 머리 칸만 그림 */
26
+ contentTypes={['word']} /* 나머지는 글자만 */
27
+ />
28
+ ```
29
+
30
+ #### 반쪽 격자는 **방향만 뒤집어** 쓴다
31
+
32
+ 종이가 A 계열이라 **반쪽은 방향만 뒤집힌 같은 비율**이다 — 가로 1123×794 의 왼쪽 절반은
33
+ 561.5×794(비 **0.7072**)로 세로 전체(**0.7070**)와 같고, 세로의 위쪽 절반은 794×561.5 로
34
+ 가로 전체와 같다. 그래서 손으로 맞춰 둔 `LAYOUTS` 를 뒤집어 그대로 쓰고 **반쪽 전용
35
+ 배치표를 또 두지 않았다.** 여덟 칸이면 가로 표의 오른쪽 절반이 2×4, 세로 표의 아래쪽
36
+ 절반이 4×2 다. 시험이 `gridFor` 를 **뒤집어** 불러 기대값을 세우므로, 구현이 안 뒤집으면
37
+ 빨개진다(심어 확인 — 2건).
38
+
39
+ #### 한 격자에 걸치게 두었다
40
+
41
+ 머리 칸을 `grid-column/row: 1 / span n` 으로 걸친다. 겹격자로 쪼개면 `--cut-show` 의 선
42
+ 바탕(격자 바탕을 선 색으로 깔고 칸이 그 위를 덮는 꼴)과 `gap: 1px` 가 **둘이 되어** 선
43
+ 굵기가 달라진다. 자르는 선은 반쪽 격자를 세고(`dotDashStyle(index, itemCols, itemRows, …)`),
44
+ 머리 칸과 나머지를 가르는 점선은 가로면 오른쪽 · 세로면 아래쪽에 따로 건다.
45
+
46
+ **배율은 손댈 것이 없었다.** `WordCell` 이 제 상자를 `ResizeObserver` 로 재어
47
+ `min(폭/refW, 키/refH)` 로 줄이므로, 걸친 머리 칸도 제 크기에 맞게 스스로 선다. 미리
48
+ 걱정했던 "걸친 칸의 배율 기준(280×400)" 은 문제가 아니었다.
49
+
50
+ #### 편집 모드는 안 받는다
51
+
52
+ `editCells` 로 그리는 편집 격자는 칸을 **번호로** 센다(활성 칸·추가 자리). 걸친 칸이
53
+ 들어오면 번호와 자리가 어긋나므로 `baseItem` 을 무시한다.
54
+
55
+ > **헛 잰 못을 하나 고쳤다.** 처음엔 편집 모드 시험이 "걸친 카드가 없다" 만 보았는데,
56
+ > 걸친 카드는 표시 쪽 가지에서만 그려지므로 `!isEdit` 를 떼도 **그 못이 안 울렸다.**
57
+ > 실제 위험은 격자 셈이라(걸친 칸도 없이 격자가 반쪽 꼴로 바뀌면 칸이 번호대로 엉뚱한
58
+ > 자리에 깔린다) **격자 자체를 재게** 고쳤다. 그러자 울렸다.
59
+
60
+ 브라우저에서 확인했다 — 가로는 겉 4열×4줄에 머리 칸이 왼쪽 2열 전체(폭 0.500 · 키 1.000),
61
+ 세로는 겉 4열×4줄에 머리 칸이 위 2줄 전체(폭 1.000 · 키 0.500), `items` 여덟 칸이 다 서고
62
+ 넘친 칸 0. **그림은 놀이터에 해석기가 없어 눈으로 못 봤다** — 그 자리는 시험에서 해석기를
63
+ 심어 "머리 칸에 그림 1 · 나머지 칸에 0" 으로 재고, 해석기가 있으면 `contentTypes` 만으로도
64
+ 칸마다 그림이 서는 것까지 함께 재어 헛 잼을 막았다.
65
+
66
+ 말귀가 처음 청한 것은 셋(`WordCell` 공개 · `itemContentTypes` · `itemSpan`)이었는데,
67
+ 사장님이 이 하나로 묶어 주셔서 **공개면이 안 늘었다** — `WordCell` 은 그대로 모듈 사삿이다.
68
+
69
+ ## 0.371.0 — 단어표 칸을 **열여섯까지**
70
+
71
+ ### 단어표 칸 상한을 12 → **16** 으로
72
+
73
+ 사장님 결정(2026-10-27) · 말귀 청. **세 자리가 함께 움직여야 한다** — 하나라도 빠지면
74
+ 터지지 않고 모양만 망가진다.
75
+
76
+ **① `CELL_COUNTS` 에 13~16.** 앱의 `MAX_SELECT` 가 짝 시험으로 `Math.max(...CELL_COUNTS)`
77
+ 에 묶여 있어 여기가 와야 앱에서 16을 고를 수 있다.
78
+
79
+ **② `LAYOUTS` 에 13~16 을 손으로 적는다.** 표에 없는 수는 `gridFor` 의 자동 셈
80
+ (`sqrt(n*0.707)`)이 만들어 내는데, 그 셈은 **행을 늘려** 칸을 쪼그라뜨린다.
81
+
82
+ ```
83
+ 가로 13~15 → 5×3 · 16 → 6×3 세로 13~16 → 4×4
84
+ ```
85
+
86
+ **행을 묶어 두는 것이 핵이다.** 칸 배율은 `min(칸폭/280, 칸높이/400)` 이고 A4 에서는
87
+ **높이가 병목**이라, 행만 안 늘면 열은 늘어도 칸이 안 작아진다. 말귀가 보낸 셈을 **내가
88
+ 다시 재어** 같은 값을 얻었다:
89
+
90
+ | | 가로(1123×794) | 세로(794×1123) |
91
+ |---|---|---|
92
+ | 12칸 | 4×3 → **0.6617** | 3×4 → **0.7019** |
93
+ | 13~15 | 5×3 → 0.6617 | 4×4 → 0.7019 |
94
+ | 16 | 6×3 → 0.6617 | 4×4 → 0.7019 |
95
+ | 행 하나 늘리면 | 0.4963 | 0.5615 |
96
+
97
+ **말귀가 말 안 한 자리를 하나 찾았다 — 가로 16칸은 여유가 1% 뿐이다.** 6×3 에서 폭비
98
+ 0.6685 · 높이비 0.6617 이라 지금은 높이가 병목이지만, `REF_W_BOTH` 가 **283 을 넘으면 폭이
99
+ 병목으로 바뀌어 16칸만 작아진다.** 모양만 망가지고 아무것도 안 운다. 그 문턱을
100
+ `REF_W_BOTH_MAX_FOR_16` 으로 적고 시험이 센다.
101
+
102
+ **③ 썸네일은 여덟 칸까지만 그린다.** 전에는 전부 그려 `rows = ceil(n/2)` 로 세로가 늘었다 —
103
+ 상한이 12 였을 때 이미 6줄이었고 그 자리에서 **글자가 아랫줄과 겹친** 실측이 있다
104
+ (2026-08-28, 겹친 쌍 여덟 · `WordTableThumbnail.css` 머리말). 16칸이면 8줄이라 이 썸네일을
105
+ 쓰는 네 자리(나의 단어표 · 말귀자료실 · 채점 추가 · 어드민 자료실)의 목록이 들쭉날쭉해진다.
106
+ **여덟을 넘으면 앞 일곱 + 여덟째에 `+N`**(`wordTable.thumbMore`, ko/en `+{{count}}`).
107
+
108
+ #### 브라우저로 본 것 · 못 본 것
109
+
110
+ 가로 16칸이 **6×3**, 세로가 **4×4** 로 서고 용지 밖으로 안 흘러나간다(격자 6열 3줄 · 칸 18 =
111
+ 16 + 빈 둘). 썸네일은 16칸이어도 **8칸 · 4줄** 로 다른 카드와 같고 `+9` 가 가운데 흐린 글씨로 선다
112
+ (놀이터 조각 견본에서 키 140px · 실제 카드에서 290px — 아래 ④ 참조).
113
+
114
+ **그림 칸은 눈으로 못 봤다** — 놀이터는 이미지 리졸버를 등록하지 않아 그림이 안 뜬다. 배율
115
+ 판단의 근거가 그림 칸(280×400)인데, 그 자리는 **수로 재고 시험으로 못 박았다.** 놀이터
116
+ 보기도 그래서 `contentTypes={['word']}` 다.
117
+
118
+ 놀이터에 **16칸 보기**를 가로·세로로 더했다 — 디자인 시스템이 새 상한을 보여야 한다.
119
+
120
+ #### 못이 둘 울었다
121
+
122
+ **`'use client'`** — 썸네일에 `useTranslation` 을 들이면서 안 붙였다. 옆 파일들은 다 갖고
123
+ 있는데 이 파일만 훅이 없어 안 갖고 있던 자리다(`useClientDirective`).
124
+
125
+ **시험의 한글 이름** — 또 썼다(`빠진것`·`열두칸`·`행넷`·`문턱`). 다만 이번에는 지난주에
126
+ 적어 둔 대로 **담기 전에 그 문을 먼저 돌려** 관문 한 바퀴를 아꼈다.
127
+
128
+ 심어서 넷을 확인했다 — 13~16 격자 걷기 · 가로 16칸 행을 4 로 · 썸네일 묶기 걷기 ·
129
+ `CELL_COUNTS` 되돌리기.
130
+
131
+ ### ④ 썸네일 높이는 **140px 이 아니다** — 카드가 290px 로 덮는다
132
+
133
+ 위 ③을 넣은 뒤, 말귀가 "대립쌍표 카드에서는 네 칸만 보인다" 고 짚어 주었다. 재 보니
134
+ **둘 다 틀렸다** — 그 자리는 140px 이 아니다.
135
+
136
+ `.word-table-thumb` 는 `height: 140px` 인데, 카드(`WordTableButton`)가 **같은 요소**에
137
+ `.word-table-button__thumb { height: 290px }` 를 건다. 둘 다 클래스 하나라 특이도가 같고
138
+ **나중에 실린 쪽이 이긴다.** `WordTableButton.tsx` 가 썸네일을 먼저(6줄) 제 CSS 를
139
+ 나중(11줄) 부르므로 **290px 가 이긴다** — 지어 둔 `components.esm.css` 에서
140
+ `.word-table-thumb` 314082 → `.word-table-button__thumb` 315638 바이트, 카드의 계산 높이
141
+ 290px(속 289) · 폭 278 · 칸 속폭 131px 로 확인했다.
142
+
143
+ 한 줄 높이를 재어(틈 1px) 두 자리에 대입하면:
144
+
145
+ | 칸에 쌓인 낱말 | 한 줄 | 290px 카드 | 140px 맨몸 |
146
+ |---|---|---|---|
147
+ | 하나 | 24.80px | 22칸 | 10칸 |
148
+ | 둘(대립쌍) | **46.59px** | **12칸** | 4칸 |
149
+ | 셋 | 68.39px | 8칸 | 4칸 |
150
+
151
+ **그래서 아무것도 잘리고 있지 않았다.** 카드에서 세워 재니 대립쌍 12칸은 12/12, 낱말
152
+ 16칸은 16/16 이 다 보인다. 잘리는 것은 **대립쌍 13~16칸** 하나뿐이다(8줄 380px →
153
+ 12/16). ③의 여덟 묶기는 **잘림을 막는 것이 아니라 카드가 8줄로 빽빽해지는 것을 막는
154
+ 것**이고, 여덟은 카드에서 양쪽 다 다 보인다(대립쌍 8칸 4줄 189px → 8/8).
155
+
156
+ 그러니 상한을 쌓인 낱말 수로 가르지 **않는다.** 한때 "대립쌍이면 넷" 으로 넣었다가
157
+ 되돌렸다 — 그렇게 하면 카드에서 다 보이는 칸 여덟을 공짜로 버린다. 맨몸 140px 로 쓰는
158
+ 자리는 코어에도 소비자에도 없다(둘 다 `WordTableButton` 만 쓴다).
159
+
160
+ #### 남긴 것: `test/thumbHeightOverride1027.test.ts`
161
+
162
+ 이 함정이 두 세션의 셈을 함께 틀리게 했다. 이기는 쪽이 **import 줄 순서 하나**에
163
+ 걸려 있어서, `import './WordTableButton.css'` 를 위로 올리면 카드가 **조용히** 140px 로
164
+ 내려앉고 대립쌍 카드가 12칸 → 4칸이 된다. 터지지 않는다. 그래서 세 가지를 못으로 박았다 —
165
+ 두 높이가 적혀 있는지, 카드 쪽이 더 큰지(140/290), 썸네일을 **먼저** 부르는지. 심어
166
+ 깨뜨려 울리는 것을 확인했다(줄 뒤집기 1개 · 카드도 140 으로 1개 · 높이 선언 떼기 2개).
167
+
168
+ > **배운 것.** 자식 높이를 더해 산 수는 믿을 것이 아니다 — 제가 처음 산 42.59px 는 칸 속
169
+ > flex 틈 2px×2 를 빼먹은 값이었다(실제 46.59px). 그리고 **어느 상자를 재는지**가 수보다
170
+ > 먼저다. 말귀의 28px·52px, 제 42.59px, 그리고 "140px 에서 잘린다" 는 양쪽의 전제가
171
+ > 전부 틀렸는데, 바로잡은 것은 셈이 아니라 **세워서 재어 본 것**이었다.
172
+
10
173
  ## 0.370.0 — 정해 둔 폭에 **내용이 안 들어가면 알려 준다**
11
174
 
12
175
  사장님이 놀이터 화면에서 짚으셨다 — *"우측 잘리는데?"*. '작업' 열을 `150px` 로 못