@ihabdevteam/core 0.370.0 → 0.371.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,110 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.371.0 — 단어표 칸을 **열여섯까지**
11
+
12
+ ### 단어표 칸 상한을 12 → **16** 으로
13
+
14
+ 사장님 결정(2026-10-27) · 말귀 청. **세 자리가 함께 움직여야 한다** — 하나라도 빠지면
15
+ 터지지 않고 모양만 망가진다.
16
+
17
+ **① `CELL_COUNTS` 에 13~16.** 앱의 `MAX_SELECT` 가 짝 시험으로 `Math.max(...CELL_COUNTS)`
18
+ 에 묶여 있어 여기가 와야 앱에서 16을 고를 수 있다.
19
+
20
+ **② `LAYOUTS` 에 13~16 을 손으로 적는다.** 표에 없는 수는 `gridFor` 의 자동 셈
21
+ (`sqrt(n*0.707)`)이 만들어 내는데, 그 셈은 **행을 늘려** 칸을 쪼그라뜨린다.
22
+
23
+ ```
24
+ 가로 13~15 → 5×3 · 16 → 6×3 세로 13~16 → 4×4
25
+ ```
26
+
27
+ **행을 묶어 두는 것이 핵이다.** 칸 배율은 `min(칸폭/280, 칸높이/400)` 이고 A4 에서는
28
+ **높이가 병목**이라, 행만 안 늘면 열은 늘어도 칸이 안 작아진다. 말귀가 보낸 셈을 **내가
29
+ 다시 재어** 같은 값을 얻었다:
30
+
31
+ | | 가로(1123×794) | 세로(794×1123) |
32
+ |---|---|---|
33
+ | 12칸 | 4×3 → **0.6617** | 3×4 → **0.7019** |
34
+ | 13~15 | 5×3 → 0.6617 | 4×4 → 0.7019 |
35
+ | 16 | 6×3 → 0.6617 | 4×4 → 0.7019 |
36
+ | 행 하나 늘리면 | 0.4963 | 0.5615 |
37
+
38
+ **말귀가 말 안 한 자리를 하나 찾았다 — 가로 16칸은 여유가 1% 뿐이다.** 6×3 에서 폭비
39
+ 0.6685 · 높이비 0.6617 이라 지금은 높이가 병목이지만, `REF_W_BOTH` 가 **283 을 넘으면 폭이
40
+ 병목으로 바뀌어 16칸만 작아진다.** 모양만 망가지고 아무것도 안 운다. 그 문턱을
41
+ `REF_W_BOTH_MAX_FOR_16` 으로 적고 시험이 센다.
42
+
43
+ **③ 썸네일은 여덟 칸까지만 그린다.** 전에는 전부 그려 `rows = ceil(n/2)` 로 세로가 늘었다 —
44
+ 상한이 12 였을 때 이미 6줄이었고 그 자리에서 **글자가 아랫줄과 겹친** 실측이 있다
45
+ (2026-08-28, 겹친 쌍 여덟 · `WordTableThumbnail.css` 머리말). 16칸이면 8줄이라 이 썸네일을
46
+ 쓰는 네 자리(나의 단어표 · 말귀자료실 · 채점 추가 · 어드민 자료실)의 목록이 들쭉날쭉해진다.
47
+ **여덟을 넘으면 앞 일곱 + 여덟째에 `+N`**(`wordTable.thumbMore`, ko/en `+{{count}}`).
48
+
49
+ #### 브라우저로 본 것 · 못 본 것
50
+
51
+ 가로 16칸이 **6×3**, 세로가 **4×4** 로 서고 용지 밖으로 안 흘러나간다(격자 6열 3줄 · 칸 18 =
52
+ 16 + 빈 둘). 썸네일은 16칸이어도 **8칸 · 4줄** 로 다른 카드와 같고 `+9` 가 가운데 흐린 글씨로 선다
53
+ (놀이터 조각 견본에서 키 140px · 실제 카드에서 290px — 아래 ④ 참조).
54
+
55
+ **그림 칸은 눈으로 못 봤다** — 놀이터는 이미지 리졸버를 등록하지 않아 그림이 안 뜬다. 배율
56
+ 판단의 근거가 그림 칸(280×400)인데, 그 자리는 **수로 재고 시험으로 못 박았다.** 놀이터
57
+ 보기도 그래서 `contentTypes={['word']}` 다.
58
+
59
+ 놀이터에 **16칸 보기**를 가로·세로로 더했다 — 디자인 시스템이 새 상한을 보여야 한다.
60
+
61
+ #### 못이 둘 울었다
62
+
63
+ **`'use client'`** — 썸네일에 `useTranslation` 을 들이면서 안 붙였다. 옆 파일들은 다 갖고
64
+ 있는데 이 파일만 훅이 없어 안 갖고 있던 자리다(`useClientDirective`).
65
+
66
+ **시험의 한글 이름** — 또 썼다(`빠진것`·`열두칸`·`행넷`·`문턱`). 다만 이번에는 지난주에
67
+ 적어 둔 대로 **담기 전에 그 문을 먼저 돌려** 관문 한 바퀴를 아꼈다.
68
+
69
+ 심어서 넷을 확인했다 — 13~16 격자 걷기 · 가로 16칸 행을 4 로 · 썸네일 묶기 걷기 ·
70
+ `CELL_COUNTS` 되돌리기.
71
+
72
+ ### ④ 썸네일 높이는 **140px 이 아니다** — 카드가 290px 로 덮는다
73
+
74
+ 위 ③을 넣은 뒤, 말귀가 "대립쌍표 카드에서는 네 칸만 보인다" 고 짚어 주었다. 재 보니
75
+ **둘 다 틀렸다** — 그 자리는 140px 이 아니다.
76
+
77
+ `.word-table-thumb` 는 `height: 140px` 인데, 카드(`WordTableButton`)가 **같은 요소**에
78
+ `.word-table-button__thumb { height: 290px }` 를 건다. 둘 다 클래스 하나라 특이도가 같고
79
+ **나중에 실린 쪽이 이긴다.** `WordTableButton.tsx` 가 썸네일을 먼저(6줄) 제 CSS 를
80
+ 나중(11줄) 부르므로 **290px 가 이긴다** — 지어 둔 `components.esm.css` 에서
81
+ `.word-table-thumb` 314082 → `.word-table-button__thumb` 315638 바이트, 카드의 계산 높이
82
+ 290px(속 289) · 폭 278 · 칸 속폭 131px 로 확인했다.
83
+
84
+ 한 줄 높이를 재어(틈 1px) 두 자리에 대입하면:
85
+
86
+ | 칸에 쌓인 낱말 | 한 줄 | 290px 카드 | 140px 맨몸 |
87
+ |---|---|---|---|
88
+ | 하나 | 24.80px | 22칸 | 10칸 |
89
+ | 둘(대립쌍) | **46.59px** | **12칸** | 4칸 |
90
+ | 셋 | 68.39px | 8칸 | 4칸 |
91
+
92
+ **그래서 아무것도 잘리고 있지 않았다.** 카드에서 세워 재니 대립쌍 12칸은 12/12, 낱말
93
+ 16칸은 16/16 이 다 보인다. 잘리는 것은 **대립쌍 13~16칸** 하나뿐이다(8줄 380px →
94
+ 12/16). ③의 여덟 묶기는 **잘림을 막는 것이 아니라 카드가 8줄로 빽빽해지는 것을 막는
95
+ 것**이고, 여덟은 카드에서 양쪽 다 다 보인다(대립쌍 8칸 4줄 189px → 8/8).
96
+
97
+ 그러니 상한을 쌓인 낱말 수로 가르지 **않는다.** 한때 "대립쌍이면 넷" 으로 넣었다가
98
+ 되돌렸다 — 그렇게 하면 카드에서 다 보이는 칸 여덟을 공짜로 버린다. 맨몸 140px 로 쓰는
99
+ 자리는 코어에도 소비자에도 없다(둘 다 `WordTableButton` 만 쓴다).
100
+
101
+ #### 남긴 것: `test/thumbHeightOverride1027.test.ts`
102
+
103
+ 이 함정이 두 세션의 셈을 함께 틀리게 했다. 이기는 쪽이 **import 줄 순서 하나**에
104
+ 걸려 있어서, `import './WordTableButton.css'` 를 위로 올리면 카드가 **조용히** 140px 로
105
+ 내려앉고 대립쌍 카드가 12칸 → 4칸이 된다. 터지지 않는다. 그래서 세 가지를 못으로 박았다 —
106
+ 두 높이가 적혀 있는지, 카드 쪽이 더 큰지(140/290), 썸네일을 **먼저** 부르는지. 심어
107
+ 깨뜨려 울리는 것을 확인했다(줄 뒤집기 1개 · 카드도 140 으로 1개 · 높이 선언 떼기 2개).
108
+
109
+ > **배운 것.** 자식 높이를 더해 산 수는 믿을 것이 아니다 — 제가 처음 산 42.59px 는 칸 속
110
+ > flex 틈 2px×2 를 빼먹은 값이었다(실제 46.59px). 그리고 **어느 상자를 재는지**가 수보다
111
+ > 먼저다. 말귀의 28px·52px, 제 42.59px, 그리고 "140px 에서 잘린다" 는 양쪽의 전제가
112
+ > 전부 틀렸는데, 바로잡은 것은 셈이 아니라 **세워서 재어 본 것**이었다.
113
+
10
114
  ## 0.370.0 — 정해 둔 폭에 **내용이 안 들어가면 알려 준다**
11
115
 
12
116
  사장님이 놀이터 화면에서 짚으셨다 — *"우측 잘리는데?"*. '작업' 열을 `150px` 로 못