@ihabdevteam/core 0.374.0 → 0.376.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 +120 -0
- package/dist/components.cjs.js +174 -174
- package/dist/components.esm.css +1 -1
- package/dist/hooks.cjs.js +3 -3
- package/dist/i18n.cjs.js +3 -3
- package/dist/ihabdevteam-core.cjs.js +179 -179
- package/dist/ihabdevteam-core.d.ts +44 -3
- package/dist/packages/core/src/components/Button.css +8 -0
- package/dist/packages/core/src/components/Button.js +18 -5
- package/dist/packages/core/src/components/Training/TrainingWordCard.js +14 -2
- package/dist/packages/core/src/components/Word/WordTableBlock.d.ts +1 -1
- package/dist/packages/core/src/components/Word/WordTableBlock.js +38 -16
- package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +15 -0
- package/dist/packages/core/src/components/WordTable.d.ts +10 -1
- package/dist/packages/core/src/components/WordTable.js +84 -7
- package/dist/packages/core/src/components/buttonTypes.d.ts +17 -0
- package/dist/packages/core/src/i18n/locales/en.json +1 -0
- package/dist/packages/core/src/i18n/locales/ko.json +1 -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 +3 -3
- package/package.json +2 -1
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,126 @@ All notable changes to this project will be documented in this file.
|
|
|
7
7
|
> 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
|
|
8
8
|
> 제 이야기를 못 찾는다.
|
|
9
9
|
|
|
10
|
+
## 0.376.0 — 말귀 청 넷 (327)·(328)·(329)·(330)
|
|
11
|
+
|
|
12
|
+
### (330) 단추에 **기다리는 꼴** — `Button` 의 `loading`
|
|
13
|
+
|
|
14
|
+
사장님 지시(2026-10-28) *"재생버튼을 누르고 재생상태로 전환될 때까지 시간이 너무 오래
|
|
15
|
+
걸려서 … 아이콘 대신 스피너 … **core에 요청해서 공용화**"*.
|
|
16
|
+
|
|
17
|
+
소리 단추가 쥐는 때는 **셋**인데 꼴은 둘뿐이었다 — `재생`/`멈춤` 만 있고 *받아 오는 중*
|
|
18
|
+
이 없었다. 음원이 없는 낱말은 누른 뒤 합성을 기다리는데(말귀 실측 **처음 3,567ms** ·
|
|
19
|
+
캐시가 있을 때 **772ms**), 그동안 단추가 곧바로 '멈춤' 이 되어 **눌렀는데 멈춰 있는** 꼴로
|
|
20
|
+
보였다.
|
|
21
|
+
|
|
22
|
+
`loading` 이 참이면 아이콘 자리에 `Loader variant="spinner"` 가 서고 `aria-busy` 가 붙는다.
|
|
23
|
+
`button__icon` 상자를 그대로 쓰므로 단추 크기마다 따로 잴 것이 없고, 도는 표시는
|
|
24
|
+
`aria-hidden` 으로 가린다 — 그 안의 `role="status"` 까지 함께 읽히면 두 번 말한다.
|
|
25
|
+
|
|
26
|
+
#### 막는 일은 **안 맡는다**
|
|
27
|
+
|
|
28
|
+
말귀는 *"다시 안 눌리게"* 를 함께 청했는데, 같은 쪽지에서 *"기다리는 동안 다시 누르면
|
|
29
|
+
기다림을 접는 길은 그대로 두시면 좋겠다"* 고도 적었다. 둘은 한 참/거짓으로 못 말한다 —
|
|
30
|
+
저장 단추는 **아무 일도 안 나야** 하고 소리 단추는 **접어야** 한다. 그래서 `loading` 은
|
|
31
|
+
*보이는 꼴*만 맡고, 막는 일은 이미 그 일을 하는 `disabled` 에 둔다. 빠져나갈 구멍을 하나
|
|
32
|
+
더 뚫는 것보다 **뜻이 하나씩인 쪽**이 낫다.
|
|
33
|
+
|
|
34
|
+
#### 쓰는 자리
|
|
35
|
+
|
|
36
|
+
표의 칸과 `TrainingWordCard` 에 **'받아 오는 중'을 '울리는 중'과 갈라** 두었다. 칸은
|
|
37
|
+
기다리는 동안 눌리면 그 기다림이 접힌다(합성이 한 번 더 나가지 않는다).
|
|
38
|
+
`TrainingBlockButton` 은 재 보니 **기다리는 틈이 없다** — `useAudioPreview` 는 이미 받아
|
|
39
|
+
둔 주소로 바로 튼다. 그래서 그쪽은 손대지 않았다.
|
|
40
|
+
|
|
41
|
+
### (327) `cellCapacity` — 빈 칸을 **쪽 나눔을 끄지 않고** 낸다
|
|
42
|
+
|
|
43
|
+
사장님 지시 *"활용표는 만들면 무조건 12개로 표를 제작 … 유저가 x를 누르면 칸이 비게
|
|
44
|
+
되는데 이때 + 버튼 가운데에 표현"*.
|
|
45
|
+
|
|
46
|
+
`WordTable` 은 빈 칸의 '추가하기' 를 세울 줄 알았는데 `WordTableBlock` 에서 닿는 길이 둘 다
|
|
47
|
+
막혀 있었다 — ① 빈 칸을 내는 길이 `showCellCount` 뿐인데 그것은 '칸 수' 고르개를 세우고
|
|
48
|
+
**쪽 나눔을 통째로 끈다**(전날 받은 '페이지당 단어 수' 가 사라진다). ② 쪽을 나눈 가지의
|
|
49
|
+
`WordTable` 에는 `showFillerAdd`·`onActivateCell` 이 **안 실려** 쪽이 둘이 되는 순간 단추가
|
|
50
|
+
조용히 사라졌다.
|
|
51
|
+
|
|
52
|
+
`cellCapacity` 는 *이 표가 채울 수 있는 칸 수*다. 고르개를 안 세우고 쪽 나눔도 안 끈다.
|
|
53
|
+
**쪽은 항목이 아니라 자리로 센다** — 안 그러면 항목 하나짜리 열두 칸 표가 한 쪽에 한 칸씩
|
|
54
|
+
열두 쪽이 된다.
|
|
55
|
+
|
|
56
|
+
`WordTable` 에 `addableCount` 를 함께 냈다. 칸 크기가 쪽마다 같아야 해서 `count` 는 모든
|
|
57
|
+
쪽이 '페이지당 개수' 인데, 채울 자리는 마지막 쪽에서 모자랄 수 있다(자리 12 · 쪽당 8 →
|
|
58
|
+
둘째 쪽은 네 자리뿐). `count` 로 세면 **없는 자리에도 단추가 선다.**
|
|
59
|
+
|
|
60
|
+
### (329) `hasImage` 가 **머리 칸을 센다**
|
|
61
|
+
|
|
62
|
+
사장님 지시 *"이거 왜 비활성화 되어 있어? 왼쪽 칸에 이미지 있는데?"*.
|
|
63
|
+
|
|
64
|
+
활용표는 그림이 **머리 칸에만** 있다 — 나머지 절반은 사전에 없는 활용형이라 그림이 없다.
|
|
65
|
+
물어볼 낱말을 `items` 에서만 모아 전부 헛쳐서, **왼쪽 절반에 그림이 떡하니 떠 있는데
|
|
66
|
+
'이미지' 칩만 회색**이었다. `baseItem` 의 낱말도 함께 묻는다.
|
|
67
|
+
|
|
68
|
+
### (328) 칸의 이름표를 **낱말 위로**
|
|
69
|
+
|
|
70
|
+
사장님 지시 *"~고 표현은 단어 위로"*. 이름표는 *이 칸이 무슨 꼴인가* 를 말하는 머리말이라
|
|
71
|
+
낱말 아래에 있으면 발음과 나란히 서서 **둘 다 낱말에 딸린 설명**처럼 읽힌다(실측
|
|
72
|
+
`가득하고`: `-고` 15px·회색이 낱말 바로 밑, 그 아래 `[가드카고]`).
|
|
73
|
+
|
|
74
|
+
### 곁들여
|
|
75
|
+
|
|
76
|
+
`wordTableScoreKeyboard` 의 못 하나가 **소스 글자**를 읽어 `showTooltipInfo={t('common.play',
|
|
77
|
+
'재생')}` 가 그대로 있는지 보고 있었다. 지키던 뜻은 *"띄우는 글에 낱말을 넣지 않는다"* 인데
|
|
78
|
+
글자를 재면 그 줄을 **어떤 까닭으로든** 손대는 순간 빨개진다 — 실제로 (330) 이 '불러오는
|
|
79
|
+
중' 을 더하자 그렇게 됐다. 그려진 것을 재도록 고쳤다.
|
|
80
|
+
|
|
81
|
+
### 코어가 가져간 CSS 클래스
|
|
82
|
+
|
|
83
|
+
`.button__spinner` — 단추의 기다리는 꼴. 아이콘 상자(`button__icon`)와 함께 선다.
|
|
84
|
+
|
|
85
|
+
## 0.375.0 — 표의 칸이 **합성 폴백**을 탄다
|
|
86
|
+
|
|
87
|
+
### 색인에 없는 낱말도 울린다
|
|
88
|
+
|
|
89
|
+
말귀 청 (326), 2026-10-28. 표의 칸은 `getTTSUrlResolver()` **하나만** 불렀고, 빈 글자가
|
|
90
|
+
오면 `if (!audioUrl) return` 으로 조용히 돌아섰다 — 누르면 아무 일도 안 나고 네트워크도
|
|
91
|
+
0건이었다.
|
|
92
|
+
|
|
93
|
+
활용형('불러요' · '부릅니다' …)은 사전에 없는 글자라 음원 색인에 없다. 활용표는 **모든
|
|
94
|
+
칸이 그 꼴**이라 머리 칸 하나만 들리고 나머지 열둘이 전부 먹통이었다(말귀 실측: 머리 칸만
|
|
95
|
+
`data-audio-src` 가 차 있고 열두 꼴이 모두 `''`).
|
|
96
|
+
|
|
97
|
+
메우는 자리는 `configureTTS` 의 `fallbackUrlResolver` 다 — `TrainingWordCard` 가 이미
|
|
98
|
+
쓰고 있고 앱이 런타임 합성을 붙여 두는 그 길이다. 코어에 길은 있었는데 `WordTable` 만
|
|
99
|
+
그것을 안 봤다.
|
|
100
|
+
|
|
101
|
+
#### 미리 부르지 않는다 — **누른 칸 하나만** 간다
|
|
102
|
+
|
|
103
|
+
그 리졸버는 음원이 없으면 **그 자리에서 합성한다**(말귀 실측 3,567ms). 칸마다 미리
|
|
104
|
+
부르면 검색 결과의 낱말 수만큼 합성이 나간다. 그래서 미리 받아 두는 것은 지금까지대로
|
|
105
|
+
`urlResolver` 뿐이고, 폴백은 **누른 뒤에** 부른다.
|
|
106
|
+
|
|
107
|
+
말귀가 *"`urlResolver` 쪽에서 폴백으로 떨어뜨리지는 말아 달라"* 고 함께 적어 주었다 —
|
|
108
|
+
그 리졸버는 `checkAudioExists`('음성 있음' 거르개)도 쓰므로, 거기서 떨어뜨리면 **거르개가
|
|
109
|
+
도는 것만으로** 합성이 나간다. 맞는 가름이라 그대로 따랐다.
|
|
110
|
+
|
|
111
|
+
#### 기다리는 동안에도 자물쇠를 쥔다
|
|
112
|
+
|
|
113
|
+
합성을 기다리는 3.5초 사이에 옆 칸을 누르거나 화면이 닫히는 일이 있다. 소리 자물쇠
|
|
114
|
+
(`claimSound`)를 **받기 전에** 잡고, 맡기는 멈춤 함수 하나가 두 때를 다 맡는다 — 아직
|
|
115
|
+
기다리는 중이면 기다림을 접고, 이미 틀고 있으면 그것을 멈춘다. 소리가 생긴 뒤에 자물쇠를
|
|
116
|
+
다시 잡으면 **다시 잡는 그 순간 제 손으로 저를 멈춘다**(`claimSound` 가 앞 주인을 멈추는데,
|
|
117
|
+
그 앞 주인이 저 자신이다).
|
|
118
|
+
|
|
119
|
+
#### 받은 주소는 들고 있는다
|
|
120
|
+
|
|
121
|
+
두 번째 누름이 3.5초를 다시 기다리지 않는다. `data-audio-src` 도 함께 차므로 인쇄 문서의
|
|
122
|
+
재생 단추가 **한 번 들어 본 칸만큼은** 살아난다.
|
|
123
|
+
|
|
124
|
+
#### 안 한 것 하나
|
|
125
|
+
|
|
126
|
+
정식 음원 주소가 **있는데 재생이 실패하는** 때(404 등)는 그대로 두었다.
|
|
127
|
+
`TrainingWordCard` 는 그때도 폴백으로 가는데, 표의 칸까지 그렇게 하면 서버가 흔들리는
|
|
128
|
+
동안 칸마다 합성이 나간다. 말귀가 잰 것은 빈 글자 쪽이고, 그 반쪽만 고쳤다.
|
|
129
|
+
|
|
10
130
|
## 0.374.0 — `WordTableBlock` 이 **머리 칸을 넘긴다**
|
|
11
131
|
|
|
12
132
|
### `baseItem` · `baseContentTypes` 가 블록을 지나 안쪽 표까지 간다
|