@ihabdevteam/core 0.423.0 → 0.425.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 +185 -0
- package/README.md +9 -4
- package/dist/components.cjs.js +183 -183
- package/dist/components.esm.css +1 -1
- package/dist/hooks.cjs.js +5 -5
- package/dist/i18n.cjs.js +1 -1
- package/dist/ihabdevteam-core-tokens.css +1 -1
- package/dist/ihabdevteam-core.cjs.js +191 -191
- package/dist/ihabdevteam-core.css +1 -1
- package/dist/ihabdevteam-core.d.ts +138 -3
- package/dist/packages/core/src/components/HeroVisual.css +390 -0
- package/dist/packages/core/src/components/HeroVisual.d.ts +102 -0
- package/dist/packages/core/src/components/HeroVisual.js +435 -0
- package/dist/packages/core/src/components/Word/WordTableBlock.d.ts +1 -1
- package/dist/packages/core/src/components/Word/WordTableBlock.js +3 -3
- package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +6 -0
- package/dist/packages/core/src/components/WordTable.d.ts +18 -1
- package/dist/packages/core/src/components/WordTable.js +2 -2
- package/dist/packages/core/src/components.d.ts +2 -0
- package/dist/packages/core/src/components.js +1 -0
- package/dist/packages/core/src/hooks/useWordPoolViability.d.ts +24 -0
- package/dist/packages/core/src/hooks/useWordPoolViability.js +101 -0
- package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -42
- package/dist/packages/core/src/hooks/useWordTrainingFilter.js +16 -245
- package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +120 -0
- package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +183 -0
- package/dist/packages/core/src/styles.css +6 -1
- package/dist/packages/core/src/tokens.css +17 -7
- 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,191 @@ All notable changes to this project will be documented in this file.
|
|
|
7
7
|
> 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
|
|
8
8
|
> 제 이야기를 못 찾는다.
|
|
9
9
|
|
|
10
|
+
## 0.425.0 — **히어로 비주얼: 안 자르기 · 한 바퀴만 돌기**
|
|
11
|
+
|
|
12
|
+
### 빈 칸의 `+` 가 **첫 칸에만** 선다 — **바뀜**(말귀 요청 386)
|
|
13
|
+
|
|
14
|
+
`showFillerAdd` 는 빈 칸**마다** `+` 를 세웠다. 그런데 **어느 빈 칸을 눌러도 다음
|
|
15
|
+
자리에 들어가므로** 단추가 여럿일 까닭이 없고, 빈 칸이 열둘인 활용표에서는 같은 `+`
|
|
16
|
+
가 넷 줄지어 서서 칸보다 단추가 먼저 읽혔다. 풍선 글(「클릭해서 추가하기」)도 넷이
|
|
17
|
+
같은 말을 했다.
|
|
18
|
+
|
|
19
|
+
이제 **쪽마다 첫 빈 칸 하나**에만 선다. 쪽이 나뉘면 쪽마다 하나다 — 다른 쪽은 안
|
|
20
|
+
보이므로 거기서도 채울 수 있어야 한다.
|
|
21
|
+
|
|
22
|
+
**옛 길이 필요하면** `fillerAdd="every"` 를 준다. `WordTable` · `WordTableBlock` 둘 다
|
|
23
|
+
받는다.
|
|
24
|
+
|
|
25
|
+
```tsx
|
|
26
|
+
<WordTableBlock items={items} onAddItem={add} fillerAdd="every" />
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
칸 셈(`count` · `addableCount` · `cellCapacity`)은 하나도 안 바뀌었다 — 채울 자리가
|
|
30
|
+
없으면 첫 칸에도 안 선다.
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
### 글자 자에 `display-0` 이 생겼다 — **새로 생겼다**(말귀 요청 385)
|
|
34
|
+
|
|
35
|
+
`display-1` **위** 한 단. 랜딩 머리글처럼 가장 크게 외치는 자리용이다.
|
|
36
|
+
|
|
37
|
+
| | 크기 | 행간 | 자간 | 굵기(`b`) |
|
|
38
|
+
|---|---|---|---|---|
|
|
39
|
+
| `display-0` | `clamp(44px, 7.2vw, 92px)` | 1.05 | -0.04em | 800 (900) |
|
|
40
|
+
|
|
41
|
+
폭별로 푼 값: **375px 44 · 768px 55.3 · 1024px 73.7 · 1440px 이상 92.**
|
|
42
|
+
92 는 지금 자의 비(44→56→72, 1.27~1.29배)를 한 번 더 밟은 수다.
|
|
43
|
+
|
|
44
|
+
**아래 끝이 `display-1` 과 같아서(둘 다 44px) 611px 아래에서는 둘이 같은 크기로 선다.**
|
|
45
|
+
좁은 쪽에서는 44px 가 머리글 한 줄이 들어갈 수 있는 끝이라, 이 단만 더 키우면 한 줄로
|
|
46
|
+
두려던 머리글이 꺾인다. 그래서 이 단만 사다리 규약이 하나 느슨하다 — 어느 폭에서도
|
|
47
|
+
`display-1 ≤ display-0` 이고, 611px 위에서 비로소 벌어진다. 그 포갬 자체를 못으로
|
|
48
|
+
박아 뒀다(뒤에 오는 사람이 "단이 둘인데 크기가 같다" 며 아래 끝을 올리지 않도록).
|
|
49
|
+
|
|
50
|
+
`.display-0` · `.display-0b` 클래스와 `--text-display-0-*` 변수 다섯이 함께 나간다.
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
### 심볼 열하나가 같은 크기로, 가운데에 선다 — **고침**
|
|
54
|
+
|
|
55
|
+
꼴마다 상자를 제각각 짜 둔 탓에, 한 줄에 세우면 **어떤 것은 크고 어떤 것은 작게** 보였다.
|
|
56
|
+
브라우저에서 **쉬는 자세**(들어오는 틀은 다 선 때, 제자리 움직임은 제 자리)의 잉크 상자를
|
|
57
|
+
재서 상자를 다시 짰다. 세 가지를 맞췄다 —
|
|
58
|
+
|
|
59
|
+
- 상자는 **네모**. 한 칸에 세우면 어느 꼴이든 같은 자리를 먹는다.
|
|
60
|
+
- 상자 가운데가 **그림 가운데**. 실측 쏠림 0.0%.
|
|
61
|
+
- 그림의 **긴 변이 상자의 88%**. 실측 0.877~0.882 로 모였다(고치기 전 0.68~1.14).
|
|
62
|
+
|
|
63
|
+
긴 변 쪽 여백은 열한 꼴 모두 **6.0%** 로 같다 — `s9 dotGrid` 만 빼고.
|
|
64
|
+
|
|
65
|
+
`dotGrid` 는 잉크가 상자의 **네 모서리까지** 닿는 유일한 꼴이라, 같은 비율로 담으면
|
|
66
|
+
유독 커 보인다. 눈은 상자가 아니라 잉크가 몰린 테두리를 크기로 읽는다. 가운데에서
|
|
67
|
+
잉크까지의 평균 거리를 재니 0.726 으로 나머지 열 꼴(0.46~0.635) 밖에 있었다. 상자를
|
|
68
|
+
1.11 배로 키워 0.645 에 맞췄다.
|
|
69
|
+
|
|
70
|
+
쓰는 쪽에서 `aspect-ratio` 가 1 로 바뀐 꼴이 있다 — 칸을 세로로 늘려 받던 자리라면
|
|
71
|
+
한 번 보라.
|
|
72
|
+
|
|
73
|
+
### 늦게 시작하는 조각이 제 차례에 안 튄다 — **고침**
|
|
74
|
+
|
|
75
|
+
차례를 두고 들어오는 조각은 기다리는 동안 **안 움직인 모습**으로 서 있다가, 제 차례가
|
|
76
|
+
오는 순간 틀의 0% 로 **뛰어들었다**. 0% 가 제자리와 다른 틀이 다 걸렸다 — `sway` 는
|
|
77
|
+
6도, `blink` 은 짙기 0.75 만큼. 말귀 실측으로 `dotGrid` 에서 300ms 간격으로 일곱 번
|
|
78
|
+
튀었다.
|
|
79
|
+
|
|
80
|
+
기다리는 동안을 틀의 0% 로 채우게 고쳤다(`animation-fill-mode: backwards`). 지연을 가진
|
|
81
|
+
틀 69 개가 다 받는다.
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
### 그림이 더는 안 잘린다 — **고침**
|
|
85
|
+
|
|
86
|
+
상자를 그림에 바짝 맞춰 둔 탓에, 숨 쉬고 떠다니느라 잠깐 밖으로 나가는 만큼이 **잘렸다.**
|
|
87
|
+
실측으로 다섯 꼴이 제 상자를 넘는다 — `spheres` 2.8% · `stackedDiscs` 4.0% ·
|
|
88
|
+
`dottedRipple` 3.1% · `ribbon` 1.6% · `blobs` 1.8%.
|
|
89
|
+
|
|
90
|
+
상자에 타를 두면 쉴 때 그림이 그만큼 작아지므로 **자르지 않는 쪽**을 골랐다
|
|
91
|
+
(`overflow: visible`). 쓰는 쪽에서 안으로 들여 받을 것이 없다.
|
|
92
|
+
|
|
93
|
+
`doubleRing` 만 그대로 자른다 — **틀 밖으로 잘리는 것이 그 꼴의 생김새**다.
|
|
94
|
+
|
|
95
|
+
### `motion="once"` · `onCycleEnd` — 새로 생겼다
|
|
96
|
+
|
|
97
|
+
```tsx
|
|
98
|
+
<HeroVisual variant="clover" motion="once" onCycleEnd={next} />
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
꼴을 **차례로 갈아 끼울** 때 쓴다. 되풀이되는 동안에는 조각마다 차례가 달라 **모두가
|
|
102
|
+
함께 비는 때가 없다** — 늦게 든 조각이 아직 사라지는 중에 첫 조각이 벌써 둘째 바퀴로
|
|
103
|
+
들어온다. 그래서 아무 때나 갈아 끼우면 **사라지는 중인 조각이 잘린다**(말귀 실측:
|
|
104
|
+
갈아끼우는 순간 `dottedRipple` 바깥 테 0.73 · `stackedDiscs` 0.56 이 아직 보였다).
|
|
105
|
+
|
|
106
|
+
`once` 는 한 바퀴만 돌고 **다 나간 채로 선다.** `onCycleEnd` 는 **가장 늦은 조각까지**
|
|
107
|
+
다 나간 뒤 한 번 불린다.
|
|
108
|
+
|
|
109
|
+
**움직임이 멎은 자리에서도 반드시 한 번은 불린다** — 움직임 줄이기, 숨은 탭에서는
|
|
110
|
+
`animationend` 가 안 오므로, 실제로 걸린 시각을 읽어 그보다 조금 뒤에 부른다. 안 그러면
|
|
111
|
+
이것으로 다음 꼴을 세우는 쪽이 첫 꼴에서 멈춘 채 조용해진다.
|
|
112
|
+
|
|
113
|
+
### 꼴 셋이 늘었다 — `squircles` · `dotGrid` · `stairs`
|
|
114
|
+
|
|
115
|
+
디자인 판 `말귀 심볼 확장` 에서 떠 왔다(`s21 breath` · `s39 nine` · `s48 stair`).
|
|
116
|
+
|
|
117
|
+
### `doubleRing` 이 **서로 꿰인 고리**가 됐다
|
|
118
|
+
|
|
119
|
+
하나가 다른 하나를 통째로 덮던 것을, **위쪽 교차에서는 왼쪽이 위로 · 아래쪽 교차에서는
|
|
120
|
+
오른쪽이 위로** 지나게 엮었다. 두 테가 만나는 자리를 재어(382, 489)·(445, 158) 그 사이인
|
|
121
|
+
y 323 에서 가른다.
|
|
122
|
+
|
|
123
|
+
상자도 **두 고리를 다 품는 자리**로 바꿨다. 히어로 카드가 오른쪽을 잘라 쓰라고 그린
|
|
124
|
+
꼴이라 오른쪽 고리가 47 잘려 있었는데, 심볼로 쓰는 자리에는 잘릴 틀이 없다.
|
|
125
|
+
그래서 **어느 꼴도 따로 자르지 않는다**(`overflow: hidden` 이 아예 없어졌다).
|
|
126
|
+
|
|
127
|
+
### 끝을 둥글린 선의 **끝점이 안 사라지던 것** — 고침
|
|
128
|
+
|
|
129
|
+
길이를 0 으로 줄여도 **둥근 마개 두 개가 점으로 남았다** — 길이는 줄어도 마개는 그
|
|
130
|
+
자리에 찍히기 때문이다. 이제 짙기도 함께 끈다. 그래서 제 짙기를 쓰는 도형은 그것을
|
|
131
|
+
바깥 묶음에 둔다.
|
|
132
|
+
|
|
133
|
+
### `stairs` 의 둥근 끝이 **눌리던 것** — 고침
|
|
134
|
+
|
|
135
|
+
둥근 네모를 세로로 늘였다 줄이면 모서리가 함께 눌려 타원이 된다. 네모를 **선**으로 바꿨다 —
|
|
136
|
+
선의 둥근 마개는 굵기로 정해지므로 길이를 어떻게 해도 동그란 채다.
|
|
137
|
+
|
|
138
|
+
### 단색이던 면에 색이 흐른다
|
|
139
|
+
|
|
140
|
+
`squircles` · `dotGrid` · `stairs` 가 줄기의 두 칸씩 걸친다. 단색이면 색판으로 읽힌다.
|
|
141
|
+
|
|
142
|
+
### `stackedPills` 가 포개진 채로 안 보인다 — **고침**
|
|
143
|
+
|
|
144
|
+
포개진 채로 또렷해졌다가 펴지고, 다시 포개진 채로 머물다 꺼졌다. 그 동안 세 장이 겹친
|
|
145
|
+
것이 그대로 드러나 거슬렸다. 지금은 **펴지면서 밝아지고 겹치면서 꺼진다.**
|
|
146
|
+
|
|
147
|
+
## 0.424.0 — **히어로 비주얼을 컴포넌트로**
|
|
148
|
+
|
|
149
|
+
랜딩 머리에 세우는 그림 열셋을 `HeroVisual` 하나가 쥔다. 디자인 판(claude.ai/design 의
|
|
150
|
+
`Hero Visual Options`)에서 고른 꼴을 `variant` 로 부른다.
|
|
151
|
+
|
|
152
|
+
### `HeroVisual` — 새로 생겼다
|
|
153
|
+
|
|
154
|
+
```tsx
|
|
155
|
+
import { HeroVisual } from '@ihabdevteam/core/components'
|
|
156
|
+
|
|
157
|
+
<div style={{ width: 520 }}>
|
|
158
|
+
<HeroVisual variant="blobs" />
|
|
159
|
+
</div>
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
**한 바퀴는 등장 · 머묾 · 퇴장**이고, 머무는 동안이 6할이다. 들고 나는 데 오래 걸리면
|
|
163
|
+
그림이 제 꼴로 서 있는 시간이 짧아져 무엇을 보여 주려던 것인지가 흐려진다.
|
|
164
|
+
|
|
165
|
+
**꼴마다 제 몸에 맞는 길로 든다** — 선은 제 손으로 그어지고(`ribbon` · `doubleRing`),
|
|
166
|
+
꽃잎·점·원판은 톡 튀어나왔다 다시 점으로 줄어들고(`clover` · `dottedRipple` ·
|
|
167
|
+
`concentric` · `stackedDiscs`), 필은 하나였다가 셋으로 갈라지고(`stackedPills`),
|
|
168
|
+
방울과 렌즈는 가운데에 겹쳐 있다 갈라지고(`metaball` · `vesica`), 구체는 제자리에서
|
|
169
|
+
오므라졌다 번지고(`spheres`), 꽃은 가운데에서 피어난다(`flower`).
|
|
170
|
+
|
|
171
|
+
`motion="still"` 은 **멈춰 선 한 장**이다. 한 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지
|
|
172
|
+
멈추고, **다 선 모습**으로 붙든다 — 들어오는 틀의 0% 는 "아직 안 나온 모습"(크기 0,
|
|
173
|
+
투명)이라, 그냥 멈추면 빈 자리가 된다. 움직임을 줄여 달라고 한 기기는 묻지 않아도
|
|
174
|
+
같은 모습이 된다.
|
|
175
|
+
|
|
176
|
+
`cycleMs` 로 한 바퀴 길이를 바꾼다(기본 9000).
|
|
177
|
+
|
|
178
|
+
**크기는 쓰는 쪽이 정한다.** 가로를 100% 채우고 세로는 제 비율대로 따라오므로, 감싸는
|
|
179
|
+
자리의 폭만 주면 된다.
|
|
180
|
+
|
|
181
|
+
**색은 CSS 변수 여섯으로 나간다**(`--hero-visual-1` … `-6`). 덮어쓰면 열셋이 한꺼번에
|
|
182
|
+
바뀐다. 이름이 빛깔이 아니라 **줄기의 몇 번째**인지를 말하는 까닭은, 덮어쓰는 쪽이 제
|
|
183
|
+
색을 넣으면 `blue` 라는 이름이 바로 거짓이 되기 때문이다.
|
|
184
|
+
|
|
185
|
+
`blobs` 와 `metaball` 만 브랜드 토큰(`--color-main` · `--color-sub`)을 쓴다 — 그 둘은
|
|
186
|
+
**지금 랜딩에 선 그림**이라 토큰이 바뀌면 함께 바뀌어야 한다.
|
|
187
|
+
|
|
188
|
+
**끝난 자리가 시작한 자리와 같다.** 나왔던 길로 되짚어 들어가므로 100% 와 0% 의 모습이
|
|
189
|
+
한 치도 안 다르고, 되풀이되는 자리에서 튀는 데가 없다. 머문 뒤에 비는 마디도 없다 —
|
|
190
|
+
퇴장이 100% 에서 끝나고 바로 다음 등장이 선다.
|
|
191
|
+
|
|
192
|
+
이름을 안 주면 `aria-hidden` 으로 숨는다. 글이 따로 있는 히어로의 배경이라, 이름을
|
|
193
|
+
읽어 주면 같은 말을 두 번 듣는다. 읽히게 하려면 `label` 을 준다.
|
|
194
|
+
|
|
10
195
|
## 0.423.0 — **제목의 자를 이름에 맞추고, 수 띠 그림자를 옅게**
|
|
11
196
|
|
|
12
197
|
판을 올리지 않은 채 셋이 쌓여 있던 것을 한 판으로 묶는다. 말귀가 쓰는 자리가 셋 다라
|
package/README.md
CHANGED
|
@@ -92,21 +92,22 @@ import '@ihabdevteam/core/tokens.css'
|
|
|
92
92
|
|
|
93
93
|
### 타입 스케일 토큰
|
|
94
94
|
|
|
95
|
-
`.display-
|
|
95
|
+
`.display-0`~`.display-3` / `.h0`~`.h5` / `.body-*` / `.button-*` / `.caption-*` 클래스의 수치는 모두 `--text-*` 변수에서 옵니다(반응형·글자 크기 스케일 포함). 다른 프레임워크로 옮길 때는 이 변수만 읽으면 됩니다.
|
|
96
96
|
|
|
97
97
|
```
|
|
98
|
-
--text-display-
|
|
98
|
+
--text-display-0-size / --text-display-0-line / --text-display-0-spacing / --text-display-0-weight / --text-display-0-weight-bold
|
|
99
99
|
--text-h0-size / --text-h0-line / --text-h0-spacing / --text-h0-weight / --text-h0-weight-bold
|
|
100
100
|
--text-body-1-size / --text-body-1-line / --text-body-1-weight / --text-body-1-weight-bold
|
|
101
101
|
--text-button-1-size / --text-caption-1-size …
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
#### 디스플레이 단(`display-
|
|
104
|
+
#### 디스플레이 단(`display-0`~`3`)은 규약이 다릅니다
|
|
105
105
|
|
|
106
|
-
`h0` **위**의
|
|
106
|
+
`h0` **위**의 네 단으로, **랜딩·히어로처럼 크게 외치는 자리 전용**입니다. 앱 화면 제목에는 `h0`~`h5` 를 쓰세요.
|
|
107
107
|
|
|
108
108
|
| | 크기 | 행간 | 자간 | 굵기(`b`) |
|
|
109
109
|
|---|---|---|---|---|
|
|
110
|
+
| `display-0` | `clamp(44px, 7.2vw, 92px)` | 1.05 | -0.04em | 800 (900) |
|
|
110
111
|
| `display-1` | `clamp(44px, 6.6vw, 72px)` | 1.05 | -0.04em | 800 (900) |
|
|
111
112
|
| `display-2` | `clamp(38px, 5.2vw, 56px)` | 1.12 | -0.03em | 700 (800) |
|
|
112
113
|
| `display-3` | `clamp(34px, 4.1vw, 44px)` | 1.2 | -0.02em | 700 (800) |
|
|
@@ -117,6 +118,10 @@ import '@ihabdevteam/core/tokens.css'
|
|
|
117
118
|
|
|
118
119
|
어느 폭에서도 `h0 < display-3 < display-2 < display-1` 이 성립합니다(1024px 처럼 `h0` 가 32→40 으로 뛰는 지점 포함).
|
|
119
120
|
|
|
121
|
+
`display-0` 만 규약이 하나 느슨합니다 — **아래 끝이 `display-1` 과 같아서(둘 다 44px) 611px 아래에서는 둘이 같은 크기로 섭니다.** 좁은 쪽에서는 44px 가 머리글 한 줄이 들어갈 수 있는 끝이라, 이 단만 더 키우면 한 줄로 두려던 머리글이 꺾이기 때문입니다. 어느 폭에서도 `display-1 ≤ display-0` 이고, 611px 위에서 비로소 벌어집니다.
|
|
122
|
+
|
|
123
|
+
폭별로 푼 값: **375px 44 · 768px 55.3 · 1024px 73.7 · 1440px 이상 92**.
|
|
124
|
+
|
|
120
125
|
그 밖에 `--duration-fast|base|slow`, `--ease-out|in-out`(모션), `--bp-tablet|desktop`(브레이크포인트 — CSS 미디어쿼리에는 직접 쓸 수 없고 JS·Tailwind용 단일 출처), `--container-page`(콘텐츠 최대폭), `--color-text-primary|secondary|muted` · `--color-surface|surface-raised|surface-sunken` · `--color-border`(역할 기반 시맨틱 별칭)를 제공합니다.
|
|
121
126
|
|
|
122
127
|
## Subpath imports
|