@ihabdevteam/core 0.372.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 +104 -0
- package/dist/components.cjs.js +173 -173
- package/dist/components.esm.css +1 -1
- package/dist/hooks.cjs.js +1 -1
- package/dist/i18n.cjs.js +1 -1
- package/dist/ihabdevteam-core.cjs.js +186 -186
- package/dist/ihabdevteam-core.d.ts +13 -1
- 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 +9 -0
- package/dist/packages/core/src/components/WordTable.js +15 -9
- 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,110 @@ 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
|
+
|
|
10
114
|
## 0.372.0 — `WordTable` 에 **절반을 쓰는 머리 칸**(`baseItem`)
|
|
11
115
|
|
|
12
116
|
### 활용표를 위한 머리 칸
|