@ihabdevteam/core 0.371.0 → 0.373.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 +163 -0
- package/dist/components.cjs.js +178 -178
- package/dist/components.esm.css +2 -2
- package/dist/hooks.cjs.js +1 -1
- package/dist/i18n.cjs.js +1 -1
- package/dist/ihabdevteam-core.cjs.js +182 -182
- package/dist/ihabdevteam-core.d.ts +28 -2
- package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +35 -4
- package/dist/packages/core/src/components/Word/wordTableBlockTypes.js +37 -6
- package/dist/packages/core/src/components/WordTable.css +17 -0
- package/dist/packages/core/src/components/WordTable.d.ts +15 -1
- package/dist/packages/core/src/components/WordTable.js +47 -15
- package/dist/packages/core/src/components/wordTableLayout.d.ts +40 -0
- package/dist/packages/core/src/components/wordTableLayout.js +64 -0
- package/dist/packages/core/src/types/wordSearch.d.ts +12 -0
- package/dist/packages/core/src/version.d.ts +1 -1
- package/dist/packages/core/src/version.js +1 -1
- package/dist/utils.cjs.js +1 -1
- package/package.json +1 -1
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.373.0 — 칸 상한을 **12 로 되돌린다** · 칸 밑 **이름표**
|
|
11
|
+
|
|
12
|
+
### 칸 상한을 16 → **12 로 되돌린다**, 페이지당 개수에 **6**
|
|
13
|
+
|
|
14
|
+
사장님 결정(2026-10-27) · 말귀 청. **같은 날 올렸다가 되돌린 것이다** — 0.371.0 에서
|
|
15
|
+
12 → 16 으로 올렸고, 사장님이 화면에서 16을 보신 뒤 12 로 돌리기로 하셨다.
|
|
16
|
+
|
|
17
|
+
#### 되돌린 까닭은 배율이 아니라 **빈 칸**이다
|
|
18
|
+
|
|
19
|
+
올릴 때 지켰던 것(행을 묶어 **배율이 안 깎이게** 한 것)은 그대로 맞았다 — 12~16 이 가로
|
|
20
|
+
`.6617` · 세로 `.7019` 로 같다. 깎이지 않는 대신 **빈 칸이 생긴다:**
|
|
21
|
+
|
|
22
|
+
| 칸 수 | 가로 | 빈칸 | 세로 | 빈칸 |
|
|
23
|
+
|---|---|---|---|---|
|
|
24
|
+
| **12** | 4×3 | **0** | 3×4 | **0** |
|
|
25
|
+
| 15 | 5×3 | 0 | 4×4 | 1 |
|
|
26
|
+
| 16 | 6×3 | **2** ← 사장님이 보신 것 | 4×4 | 0 |
|
|
27
|
+
|
|
28
|
+
**16의 가로는 고칠 길이 없다.** 행을 3 으로 묶은 채 꽉 채우려면 열이 정수로 안 나오고
|
|
29
|
+
(16/3), 행을 4 로 바꾸면 4×4 로 꽉 차는 대신 배율이 `.6617` → `.4963` 으로 깎인다.
|
|
30
|
+
양쪽 다 꽉 차는 수는 **12 가 마지막**이다.
|
|
31
|
+
|
|
32
|
+
> **말귀의 셈 네 줄 중 하나를 고쳤다.** 18칸을 "가로 6×3 · 빈칸 0" 으로 적어 왔는데,
|
|
33
|
+
> 18 은 `LAYOUTS` 에 없어 `gridFor` 의 자동 셈으로 떨어진다 — **가로 5×4(빈칸 2 · 배율
|
|
34
|
+
> `.4963`)** 다. 틀린 쪽이 오히려 12 로 가는 근거를 세게 만든다: 18 은 세로만 쪼그라드는
|
|
35
|
+
> 것이 아니라 **양쪽이 다** 쪼그라든다.
|
|
36
|
+
|
|
37
|
+
#### `LAYOUTS` 의 13~16 은 **지우지 않았다**
|
|
38
|
+
|
|
39
|
+
고를 수 없게 되었을 뿐 틀린 값이 아니다 — 행을 묶어 배율을 지키도록 손으로 맞춘 값이고,
|
|
40
|
+
단어풀에서 골라 인쇄하는 길이 열리면 다시 쓴다. **잠든 값이라 지워질 위험이 있어** 못을
|
|
41
|
+
따로 박았다(`13~16 의 격자는 CELL_COUNTS 밖에서도 살아 있다`). 지우면 자동 셈으로 떨어져
|
|
42
|
+
행이 늘고 칸이 쪼그라드는데, 손으로 맞춘 값이라 되찾기 어렵다.
|
|
43
|
+
|
|
44
|
+
#### 페이지당 개수에 **6** 을 더했다 — `[8, 6, 4, 2, 1]`
|
|
45
|
+
|
|
46
|
+
사장님 지시(2026-10-27, *"페이지당 단어수 6 추가"*). 8 과 4 사이가 비어 있던 자리다.
|
|
47
|
+
6 이 뜻이 있는 까닭은 **양쪽 방향 다 꽉 차는 수**라는 것이다 — 가로 3×2 · 세로 2×3.
|
|
48
|
+
12칸 표를 두 장으로 나눌 때 빈 칸이 안 생긴다.
|
|
49
|
+
|
|
50
|
+
**그 성질 자체를 쟀다.** 배열만 재면 누가 7 이나 5 를 끼워 넣어도 안 울린다 — 그래서
|
|
51
|
+
`ITEMS_PER_PAGE_OPTIONS` 의 **모든 값**이 양쪽 다 빈 칸 0 인 것과, 모두 `CELL_COUNTS`
|
|
52
|
+
안에 있는 것(고를 수 없는 개수를 내놓지 않게)을 함께 잰다.
|
|
53
|
+
|
|
54
|
+
> **못 넷을 깨뜨려 울리는지 확인했다** — 상한을 13 으로 올림(1건) · 16의 가로를 4×4 로
|
|
55
|
+
> 바꿈(4건) · 잠든 16 격자를 지움(5건) · 페이지당에 7 을 끼움(1건). 넷 다 울렸다.
|
|
56
|
+
|
|
57
|
+
**앱 쪽은 말귀가 `MAX_SELECT = 12` 로 이미 돌려 두었다.** 짝 시험
|
|
58
|
+
`expect(MAX_SELECT).toBe(Math.max(...CELL_COUNTS))` 가 앱 12 ↔ 코어 16 으로 빨간 채
|
|
59
|
+
기다리고 있었고, 이 판이 닿으면 초록이 된다.
|
|
60
|
+
|
|
61
|
+
### 칸 밑에 작게 붙는 **이름표**(`captionLabel`)
|
|
62
|
+
|
|
63
|
+
`WordSearchResultWord.captionLabel?: string` — 낱말 **바로 밑**에 `h5`·회색으로 선다
|
|
64
|
+
(`.word-table-cell__caption`). **안 주면 안 선다.** 머리 칸·낱칸 양쪽에 다 내려 준다.
|
|
65
|
+
|
|
66
|
+
활용표를 위한 자리다. 거기서는 칸마다 **같은 낱말의 다른 꼴**이 서므로 글자만 보고 어느
|
|
67
|
+
꼴인지 가릴 수 없다 — `감사했다` 가 과거인 것은 알아도 `감사하고` 가 무엇인지는 사람마다
|
|
68
|
+
다르게 읽는다. `-아/어요` · `과거` 가 서는 자리다.
|
|
69
|
+
|
|
70
|
+
> **발음(`subLabel`) 자리에 적으면 안 된다.** 칸의 재생 단추가 `subLabel || label` 로 소리를
|
|
71
|
+
> 받아 오므로, 거기 이름표를 적으면 칸이 **`-아/어요` 를 소리 내어 읽는다**(말귀 실측).
|
|
72
|
+
> 시험이 그 자리를 잰다 — 이름표가 대괄호를 안 두르고 `__sub` 마디로 안 새는 것.
|
|
73
|
+
|
|
74
|
+
### `WordTable` 의 칸 열쇠를 **번호로** 고친다 — 같은 낱말이 여러 칸에 설 때 터졌다
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
Encountered two children with the same key: 감사하다#1
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
열쇠가 `item.id` 였다. **활용표는 한 낱말의 열두 꼴이 모두 그 낱말의 `id` 를 쥔다** —
|
|
81
|
+
네 칸이 다 `감사하다#1` 이라 React 가 칸들을 하나로 보았다(말귀 브라우저 실측).
|
|
82
|
+
`key={index}` 로 고쳤다. **번호가 곧 칸의 정체다** — 격자 자리(`dotDashStyle(index, …)`)도
|
|
83
|
+
채점 열쇠(`renderScore(index, …)`)도 빈 칸 셈도 전부 번호로 센다.
|
|
84
|
+
|
|
85
|
+
> **`id` 를 번호에 묶으면(`${index}-${item.id}`) 겹침은 풀리지만 다른 것이 깨진다.** 세워
|
|
86
|
+
> 재었다 — 자리바꿈(A,B → B,A)에 두 칸의 DOM 마디가 **다 갈렸다**(`false / false`), 그냥
|
|
87
|
+
> 다시그림에는 살아 있었다(`true / true`). 이 표에는 끌어 옮기기(`onReorder`)가 있고
|
|
88
|
+
> `WordCell` 은 `ResizeObserver` 로 제 상자를 재어 배율을 쥐므로, 끄는 동안 칸마다 관찰자가
|
|
89
|
+
> 뜯겼다 다시 붙고 배율이 처음부터 다시 선다. `index` 만 쓰면 마디가 산다.
|
|
90
|
+
>
|
|
91
|
+
> 앱에 *"코어 표는 칸을 번호로 그린다(`key` 가 인덱스다)"* 는 옛 주석이 있었다. 그 말을 믿고
|
|
92
|
+
> 옮겼다가 화면에서 터졌다 — **그때는 틀렸고 이제 참이 되었다.** 틀린 글이 아니라 **앞서
|
|
93
|
+
> 간** 글이었다.
|
|
94
|
+
|
|
95
|
+
#### 반쪽 격자는 **지금 그대로 둔다**
|
|
96
|
+
|
|
97
|
+
사장님 결정. `baseItem` 의 반쪽 격자가 `LAYOUTS` 를 뒤집어 쓰는데, 꼴이 넷이면
|
|
98
|
+
`gridFor('portrait', 4)` 가 **1열×4줄**이라 가로 종이 오른쪽 절반에 꼴이 세로로 쌓인다.
|
|
99
|
+
**재어 보니 2×2 면 배율이 정확히 두 배다**(`0.4963` → `0.9925`) — 반쪽을 넷으로 쪼갠
|
|
100
|
+
280.75×397 이 기준 칸 280×400 과 거의 같아, 2×2 는 **거의 안 줄어든다.** 그래도 칸이 제
|
|
101
|
+
속을 1.41배로 키워 글자가 크게 서므로(말귀 실측: 낱말 40px → 약 56px) 읽기에 모자람이
|
|
102
|
+
없다는 판단이다.
|
|
103
|
+
|
|
104
|
+
> **설계 의도는 적혀 있지 않았다.** `LAYOUTS.portrait` 가 2~5 를 한 열로 둔 까닭을 찾았으나
|
|
105
|
+
> 어디에도 없다 — 손으로 맞춘 값인데 글이 없다. 그러니 뒤집어 쓰면서 **"세로 온 장에 낱말
|
|
106
|
+
> 넷은 한 열로" 라는 읽기 결정까지 함께 끌어온 것**이고, 그 결정은 낱말 목록을 위한 것이지
|
|
107
|
+
> 꼴끼리 나란히 견주는 활용표를 위한 것이 아니었다. 비율이 같다는 셈(0.7072 ≈ 0.7070)은
|
|
108
|
+
> 맞았지만 **비율이 옮겨진다고 읽기 결정도 옮겨지는 것은 아니다.**
|
|
109
|
+
>
|
|
110
|
+
> 아픈 자리는 좁다 — 빈 칸 0 을 지키면서 배율이 가장 큰 배치를 n 마다 재어 보니 지금 값과
|
|
111
|
+
> 크게 다른 것은 **n=4 하나뿐**이다(열두 꼴은 `0.4963` ↔ `0.5013`, 1% 차). 다시 열릴 때
|
|
112
|
+
> 볼 자리로 적어 둔다.
|
|
113
|
+
|
|
114
|
+
## 0.372.0 — `WordTable` 에 **절반을 쓰는 머리 칸**(`baseItem`)
|
|
115
|
+
|
|
116
|
+
### 활용표를 위한 머리 칸
|
|
117
|
+
|
|
118
|
+
사장님 말씀(2026-10-27): *"wordtable 에서 가로일때 좌측 반, 세로일때 상단 반 을 기본형으로
|
|
119
|
+
wordcell 사용해서 표현하는것만 수정하면 그대로 쓸수 있을거 같은데?"*
|
|
120
|
+
|
|
121
|
+
**활용표**(한 낱말의 여러 꼴 — `감사하다` → `감사해요 · 감사합니다 · 감사했다 …`)를 위한
|
|
122
|
+
자리다. 모든 칸이 **같은 낱말**이라 그냥 그리면 같은 그림이 칸마다 되풀이된다(말귀 실측:
|
|
123
|
+
여덟 칸에 같은 그림 여덟 장). 그림을 머리 칸에만 두고 나머지는 글자만 세운다.
|
|
124
|
+
|
|
125
|
+
```tsx
|
|
126
|
+
<WordTable
|
|
127
|
+
items={conjugations}
|
|
128
|
+
baseItem={baseWord}
|
|
129
|
+
baseContentTypes={['image', 'word']} /* 머리 칸만 그림 */
|
|
130
|
+
contentTypes={['word']} /* 나머지는 글자만 */
|
|
131
|
+
/>
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
#### 반쪽 격자는 **방향만 뒤집어** 쓴다
|
|
135
|
+
|
|
136
|
+
종이가 A 계열이라 **반쪽은 방향만 뒤집힌 같은 비율**이다 — 가로 1123×794 의 왼쪽 절반은
|
|
137
|
+
561.5×794(비 **0.7072**)로 세로 전체(**0.7070**)와 같고, 세로의 위쪽 절반은 794×561.5 로
|
|
138
|
+
가로 전체와 같다. 그래서 손으로 맞춰 둔 `LAYOUTS` 를 뒤집어 그대로 쓰고 **반쪽 전용
|
|
139
|
+
배치표를 또 두지 않았다.** 여덟 칸이면 가로 표의 오른쪽 절반이 2×4, 세로 표의 아래쪽
|
|
140
|
+
절반이 4×2 다. 시험이 `gridFor` 를 **뒤집어** 불러 기대값을 세우므로, 구현이 안 뒤집으면
|
|
141
|
+
빨개진다(심어 확인 — 2건).
|
|
142
|
+
|
|
143
|
+
#### 한 격자에 걸치게 두었다
|
|
144
|
+
|
|
145
|
+
머리 칸을 `grid-column/row: 1 / span n` 으로 걸친다. 겹격자로 쪼개면 `--cut-show` 의 선
|
|
146
|
+
바탕(격자 바탕을 선 색으로 깔고 칸이 그 위를 덮는 꼴)과 `gap: 1px` 가 **둘이 되어** 선
|
|
147
|
+
굵기가 달라진다. 자르는 선은 반쪽 격자를 세고(`dotDashStyle(index, itemCols, itemRows, …)`),
|
|
148
|
+
머리 칸과 나머지를 가르는 점선은 가로면 오른쪽 · 세로면 아래쪽에 따로 건다.
|
|
149
|
+
|
|
150
|
+
**배율은 손댈 것이 없었다.** `WordCell` 이 제 상자를 `ResizeObserver` 로 재어
|
|
151
|
+
`min(폭/refW, 키/refH)` 로 줄이므로, 걸친 머리 칸도 제 크기에 맞게 스스로 선다. 미리
|
|
152
|
+
걱정했던 "걸친 칸의 배율 기준(280×400)" 은 문제가 아니었다.
|
|
153
|
+
|
|
154
|
+
#### 편집 모드는 안 받는다
|
|
155
|
+
|
|
156
|
+
`editCells` 로 그리는 편집 격자는 칸을 **번호로** 센다(활성 칸·추가 자리). 걸친 칸이
|
|
157
|
+
들어오면 번호와 자리가 어긋나므로 `baseItem` 을 무시한다.
|
|
158
|
+
|
|
159
|
+
> **헛 잰 못을 하나 고쳤다.** 처음엔 편집 모드 시험이 "걸친 카드가 없다" 만 보았는데,
|
|
160
|
+
> 걸친 카드는 표시 쪽 가지에서만 그려지므로 `!isEdit` 를 떼도 **그 못이 안 울렸다.**
|
|
161
|
+
> 실제 위험은 격자 셈이라(걸친 칸도 없이 격자가 반쪽 꼴로 바뀌면 칸이 번호대로 엉뚱한
|
|
162
|
+
> 자리에 깔린다) **격자 자체를 재게** 고쳤다. 그러자 울렸다.
|
|
163
|
+
|
|
164
|
+
브라우저에서 확인했다 — 가로는 겉 4열×4줄에 머리 칸이 왼쪽 2열 전체(폭 0.500 · 키 1.000),
|
|
165
|
+
세로는 겉 4열×4줄에 머리 칸이 위 2줄 전체(폭 1.000 · 키 0.500), `items` 여덟 칸이 다 서고
|
|
166
|
+
넘친 칸 0. **그림은 놀이터에 해석기가 없어 눈으로 못 봤다** — 그 자리는 시험에서 해석기를
|
|
167
|
+
심어 "머리 칸에 그림 1 · 나머지 칸에 0" 으로 재고, 해석기가 있으면 `contentTypes` 만으로도
|
|
168
|
+
칸마다 그림이 서는 것까지 함께 재어 헛 잼을 막았다.
|
|
169
|
+
|
|
170
|
+
말귀가 처음 청한 것은 셋(`WordCell` 공개 · `itemContentTypes` · `itemSpan`)이었는데,
|
|
171
|
+
사장님이 이 하나로 묶어 주셔서 **공개면이 안 늘었다** — `WordCell` 은 그대로 모듈 사삿이다.
|
|
172
|
+
|
|
10
173
|
## 0.371.0 — 단어표 칸을 **열여섯까지**
|
|
11
174
|
|
|
12
175
|
### 단어표 칸 상한을 12 → **16** 으로
|