@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.
Files changed (32) hide show
  1. package/CHANGELOG.md +185 -0
  2. package/README.md +9 -4
  3. package/dist/components.cjs.js +183 -183
  4. package/dist/components.esm.css +1 -1
  5. package/dist/hooks.cjs.js +5 -5
  6. package/dist/i18n.cjs.js +1 -1
  7. package/dist/ihabdevteam-core-tokens.css +1 -1
  8. package/dist/ihabdevteam-core.cjs.js +191 -191
  9. package/dist/ihabdevteam-core.css +1 -1
  10. package/dist/ihabdevteam-core.d.ts +138 -3
  11. package/dist/packages/core/src/components/HeroVisual.css +390 -0
  12. package/dist/packages/core/src/components/HeroVisual.d.ts +102 -0
  13. package/dist/packages/core/src/components/HeroVisual.js +435 -0
  14. package/dist/packages/core/src/components/Word/WordTableBlock.d.ts +1 -1
  15. package/dist/packages/core/src/components/Word/WordTableBlock.js +3 -3
  16. package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +6 -0
  17. package/dist/packages/core/src/components/WordTable.d.ts +18 -1
  18. package/dist/packages/core/src/components/WordTable.js +2 -2
  19. package/dist/packages/core/src/components.d.ts +2 -0
  20. package/dist/packages/core/src/components.js +1 -0
  21. package/dist/packages/core/src/hooks/useWordPoolViability.d.ts +24 -0
  22. package/dist/packages/core/src/hooks/useWordPoolViability.js +101 -0
  23. package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -42
  24. package/dist/packages/core/src/hooks/useWordTrainingFilter.js +16 -245
  25. package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +120 -0
  26. package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +183 -0
  27. package/dist/packages/core/src/styles.css +6 -1
  28. package/dist/packages/core/src/tokens.css +17 -7
  29. package/dist/packages/core/src/version.d.ts +1 -1
  30. package/dist/packages/core/src/version.js +1 -1
  31. package/dist/utils.cjs.js +1 -1
  32. package/package.json +1 -1
@@ -0,0 +1,390 @@
1
+ /*
2
+ * **히어로 비주얼** — 랜딩 머리에 세우는 그림.
3
+ *
4
+ * 색은 **디자인 판(`Hero Visual Options`)의 팔레트 그대로**다. 짙은 파랑에서 라임까지
5
+ * 여섯 칸이 한 줄기를 이룬다.
6
+ *
7
+ * **브랜드 토큰으로 끌어내 봤다가 되돌렸다**(2026-11-09). `--color-main` 에서
8
+ * `--color-sub` 로 가는 줄기로 바꾸니 여섯 칸이 파랑·틸 한 식구로 모여, **칸끼리의
9
+ * 차이가 줄어** 겹이 안 읽혔다(사용자 지시 — *"이전게 나은데? 되돌려"*). 지금 값이
10
+ * 쓰는 쪽에서 본 모습이다.
11
+ *
12
+ * `blobs` · `metaball` 두 꼴만 브랜드 토큰(`--color-main` · `--color-sub`)을 쓴다 —
13
+ * 그 둘은 **지금 랜딩에 선 그림**이라, 토큰이 바뀌면 함께 바뀌어야 한다.
14
+ *
15
+ * 이름이 빛깔이 아니라 **줄기의 몇 번째**인지를 말하는 것은 그대로 둔다. 덮어쓰는
16
+ * 쪽이 제 색을 넣으면 `blue` 라는 이름이 바로 거짓이 되기 때문이다.
17
+ *
18
+ * 덮어쓰려면 `.hero-visual` 에 변수만 주면 된다 — 꼴 전부가 한꺼번에 바뀐다.
19
+ */
20
+
21
+ .hero-visual {
22
+ --hero-visual-1: #3b6ff0;
23
+ --hero-visual-2: #499cdf;
24
+ --hero-visual-3: #2cc6f5;
25
+ --hero-visual-4: #5fe0d4;
26
+ --hero-visual-5: #8fe2f7;
27
+ --hero-visual-6: #b9f07a;
28
+ /* 한 바퀴 — 등장 · 머묾 · 퇴장. 컴포넌트가 `cycleMs` 로 덮는다 */
29
+ --hero-visual-cycle: 9000ms;
30
+
31
+ position: relative;
32
+ display: block;
33
+ width: 100%;
34
+ /* 숨 쉬며 커질 때 틀에 닿으므로 안 자른다 */
35
+ overflow: visible;
36
+ }
37
+
38
+ .hero-visual__svg {
39
+ display: block;
40
+ width: 100%;
41
+ height: 100%;
42
+ /*
43
+ * **안 자른다**(사용자 지시 2026-11-09 — *"오버 플로우 비져블로"*).
44
+ *
45
+ * 상자를 그림에 바짝 맞춰 둔 탓에, 숨 쉬고 떠다니느라 잠깐 밖으로 나가는 만큼이
46
+ * 잘렸다 — 실측으로 다섯 꼴이 제 상자의 1.6~4% 를 넘는다(`stackedDiscs` 가 가장
47
+ * 커서 4%). 상자에 타를 두면 쉴 때 그림이 그만큼 작아지므로, **자르지 않는 쪽**을
48
+ * 골랐다. 쓰는 쪽에서 안으로 들여 받을 것이 없다.
49
+ */
50
+ overflow: visible;
51
+ }
52
+
53
+
54
+ /* 블롭에서 번져 나가는 고리 — 끊임없이 커졌다 사라지므로 미리 일러둔다 */
55
+ .hero-visual__ring {
56
+ will-change: transform, opacity;
57
+ }
58
+
59
+ /*
60
+ * **들고 나는 자리.**
61
+ *
62
+ * 어느 틀로 드는지는 클래스가, **차례**는 `--hero-visual-turn` 이 정한다.
63
+ * JS 가 `animation` 같은 **표준 속성에 `var()` 를 인라인으로 주면 jsdom 이 그 값을
64
+ * 버려서**, 시험이 이 자리를 아예 못 본다(`test/inlineVarIsInvisible1020`). 사용자
65
+ * 속성으로 넘기고 받는 일은 CSS 가 한다 — 그 꼴은 jsdom 이 간직한다.
66
+ */
67
+ .hero-visual__in {
68
+ animation-duration: var(--hero-visual-cycle);
69
+ animation-timing-function: ease-in-out;
70
+ animation-iteration-count: infinite;
71
+ /* 제 차례 전에는 0% 의 모습(= 아직 안 나온 모습)으로 둔다 — 없으면 기다리는 동안
72
+ 다 그려진 채로 서 있다가 갑자기 사라진다 */
73
+ animation-fill-mode: backwards;
74
+ animation-delay: calc(var(--hero-visual-cycle) * var(--hero-visual-turn, 0));
75
+ }
76
+
77
+ /*
78
+ * **한 바퀴만 돌고 선다**(`motion="once"`).
79
+ *
80
+ * 되풀이되는 동안에는 **모두가 함께 비는 때가 없다** — 조각마다 차례(`--hero-visual-turn`)
81
+ * 가 달라, 늦게 든 조각이 아직 사라지는 중에 첫 조각이 벌써 둘째 바퀴로 들어온다.
82
+ * 꼴을 갈아 끼우려는 쪽은 그 틈을 못 찾아 **사라지는 중인 조각을 자르게 된다**
83
+ * (말귀 실측 2026-11-09: 갈아끼우는 순간 `dottedRipple` 바깥 테 0.73 · `stackedDiscs`
84
+ * 0.56 · `flower` 0.56 이 아직 보이는 채였다).
85
+ *
86
+ * `both` 가 있어야 한다 — 앞은 제 차례 전의 모습(`backwards`), 뒤는 다 나간 모습
87
+ * (`forwards`)으로 선다. 없으면 끝나자마자 **다시 또렷하게 돌아온다.**
88
+ */
89
+ .hero-visual--once .hero-visual__in {
90
+ animation-iteration-count: 1;
91
+ animation-fill-mode: both;
92
+ }
93
+
94
+ .hero-visual__in--bloom { animation-name: hero-visual-bloom; }
95
+ .hero-visual__in--draw { animation-name: hero-visual-draw; }
96
+ .hero-visual__in--fade { animation-name: hero-visual-fade; }
97
+ .hero-visual__in--settle { animation-name: hero-visual-settle; }
98
+ .hero-visual__in--pop { animation-name: hero-visual-pop; }
99
+ .hero-visual__in--fan { animation-name: hero-visual-fan; }
100
+ .hero-visual__in--meet { animation-name: hero-visual-meet; }
101
+ .hero-visual__in--unfold { animation-name: hero-visual-unfold; }
102
+
103
+ /*
104
+ * ── 한 바퀴 — 등장 · 머묾 · 퇴장 ──────────────────────────────────────────────
105
+ *
106
+ * **하나를 돌려 쓰지 않는다**(사용자 지시 2026-11-09 — *"그냥 스르륵 나오는건 재미없잖아
107
+ * 공통으로 사용하지말고"*). 꼴마다 제 몸에 맞는 길로 들고 난다 —
108
+ *
109
+ * · 선·테·막대는 **제 손으로 그어졌다 지워지고**(`draw`)
110
+ * · 꽃잎·점·원판은 **톡 튀어나오고**(`pop`)
111
+ * · 필은 **하나였다가 셋으로 갈라지고**(`fan`)
112
+ * · 구체는 **제자리에서 오므라졌다 번지고**(`settle`)
113
+ * · 방울·렌즈는 **가운데에 겹쳐 있다 갈라지고**(`meet`)
114
+ * · 꽃은 **가운데에 모였다 펴진다**(`unfold`)
115
+ *
116
+ * **머무는 동안이 한 바퀴의 6할**이다. 들고 나는 데 오래 걸리면 그림이 제 꼴로 서 있는
117
+ * 시간이 짧아져, 무엇을 보여 주려던 것인지가 흐려진다.
118
+ *
119
+ * **끝난 자리가 시작한 자리와 같다**(사용자 지시 2026-11-09 — *"애니메이션 끊기는
120
+ * 부분이 있는데 끊어지지 않게"*). 나왔던 길로 되짚어 들어가므로 100% 와 0% 의 모습이
121
+ * 한 치도 안 다르다 — 되풀이되는 자리에서 **튀는 데가 없다.**
122
+ *
123
+ * 전에는 커지며 사라졌다가(1.3) 점에서 다시 나왔다(0). 사라진 뒤라 안 보이긴 해도,
124
+ * 꺼지는 쪽과 켜지는 쪽의 **크기가 달라** 그 사이에 멈칫하는 틈이 생겼다. 머무는 뒤에
125
+ * 비는 마디(90~100%)도 걷었다 — 퇴장이 100% 에서 끝나고 바로 다음 등장이 선다.
126
+ *
127
+ * 조각이 여럿인 꼴은 `--hero-visual-in` 으로 **차례를 매긴다**(한 바퀴에 대한 비율).
128
+ * `backwards` 를 붙여, 제 차례가 오기 전에는 0% 의 모습(= 아직 안 나온 모습)으로 둔다 —
129
+ * 안 붙이면 차례를 기다리는 동안 **다 그려진 채로** 서 있다가 갑자기 사라진다.
130
+ */
131
+
132
+ @keyframes hero-visual-bloom {
133
+ 0% { opacity: 0; transform: scale(.2); }
134
+ 10% { opacity: 1; transform: scale(1.04); }
135
+ 14% { transform: scale(1); }
136
+ 76% { opacity: 1; transform: scale(1); }
137
+ 100% { opacity: 0; transform: scale(.2); }
138
+ }
139
+
140
+ /*
141
+ * 선이 제 손으로 그어졌다 **그어 온 길을 되짚어** 걷힌다. `pathLength="1"` 이라 길이가
142
+ * 달라도 같은 박자로 간다.
143
+ *
144
+ * **짙기도 함께 꺼야 한다**(사용자 지시 2026-11-09 — *"처음시작 점과 마지막 점도 완전히
145
+ * 사라지도록"*). 끝을 둥글린 선은 길이를 0 으로 줄여도 **둥근 끝 두 개가 점으로 남는다**
146
+ * — 길이는 줄어도 마개는 그 자리에 찍히기 때문이다.
147
+ *
148
+ * 그래서 짙기를 쓰는 도형은 **제 짙기를 바깥 묶음에 둔다** — 여기서 `opacity` 를 쥐므로
149
+ * 도형에 직접 적으면 덮인다.
150
+ */
151
+ @keyframes hero-visual-draw {
152
+ 0% { opacity: 0; stroke-dashoffset: 1; }
153
+ 8% { opacity: 1; }
154
+ 26%, 76% { opacity: 1; stroke-dashoffset: 0; }
155
+ 100% { opacity: 0; stroke-dashoffset: 1; }
156
+ }
157
+
158
+ @keyframes hero-visual-fade {
159
+ 0% { opacity: 0; }
160
+ 26%, 76% { opacity: 1; }
161
+ 100% { opacity: 0; }
162
+ }
163
+
164
+ /* 제자리에서 오므라졌다 번진다 — 구체처럼 테가 흐린 것은 **자리를 옮기면** 번진 자락이
165
+ 상자 밖에서 잘려 반달이 된다 */
166
+ @keyframes hero-visual-settle {
167
+ 0% { opacity: 0; transform: scale(.78); }
168
+ 14%, 76% { opacity: 1; transform: scale(1); }
169
+ 100% { opacity: 0; transform: scale(.78); }
170
+ }
171
+
172
+ /* 톡 튀어나왔다 **다시 점으로** 줄어든다 */
173
+ @keyframes hero-visual-pop {
174
+ 0% { opacity: 0; transform: scale(0); }
175
+ 11% { opacity: 1; transform: scale(1.08); }
176
+ 15%, 76% { opacity: 1; transform: scale(1); }
177
+ 100% { opacity: 0; transform: scale(0); }
178
+ }
179
+
180
+ /*
181
+ * **하나였다가 여럿으로 갈라진다**(사용자 지시 2026-11-09 — *"1개였다가 4개로 배치되는
182
+ * 방식으로 나오게 해줘"*).
183
+ *
184
+ * 장들이 **같은 자리에 같은 각으로** 겹쳐 있다가(`--dy` 만큼 가운데로 모이고 각은 0),
185
+ * 제 자리와 제 기울기로 흩어진다. 모였을 때 한 치도 안 어긋나야 **하나로 보인다** —
186
+ * 그래서 각까지 여기서 돌린다(`--a`).
187
+ *
188
+ * 전에는 좌우로 펴지게 했는데(`scaleX`), 납작한 막대가 가로로만 늘면 **Y 축을 도는
189
+ * 것처럼** 보여 2D 가 깨졌다(사용자 지시 — *"y 축 로테이션 별로야 2d 공간을 유지"*).
190
+ *
191
+ * **포개진 모습은 안 보인다.** 한때 포개진 채로 또렷해졌다가(9%) 펴지고, 다시 포개진
192
+ * 채로 머물다 꺼졌는데(93%), 그 동안 세 장이 겹친 것이 그대로 드러나 거슬렸다(사용자
193
+ * 지시 2026-11-09 — *"나오는 초반이나 사라지는 마지막에 겹쳐있는게 좀 많이 보여서
194
+ * 거슬려 펴지면서 나오고 겹치면서 사라지도록"*). 지금은 **펴지면서 밝아지고 겹치면서
195
+ * 꺼진다** — 포개진 자리는 투명한 자리와 겹친다.
196
+ */
197
+ @keyframes hero-visual-fan {
198
+ 0% { opacity: 0; transform: translateY(var(--dy, 0)) rotate(0deg) scale(.96); }
199
+ 26%, 76% { opacity: 1; transform: translateY(0) rotate(var(--a, 0deg)) scale(1); }
200
+ 100% { opacity: 0; transform: translateY(var(--dy, 0)) rotate(0deg) scale(.96); }
201
+ }
202
+
203
+ /*
204
+ * **안쪽에서 와 제자리로 간다** — `--from` 은 가운데 쪽으로의 거리다(사용자 지시
205
+ * 2026-11-09 — *"안쪽에서 오게 고쳐줘"*).
206
+ *
207
+ * 처음에는 틀 **밖에서** 날아오게 했는데, 상자를 쉬는 자리에 바짝 맞춰 둔 탓에 그
208
+ * 여정이 상자 밖이라 **들어오는 동안 반달로 잘렸다**(`s4 베시카` 실측). 상자를 넓히면
209
+ * 쉴 때 빈 자리가 생기므로, 여정을 안쪽으로 접었다.
210
+ */
211
+
212
+ @keyframes hero-visual-meet {
213
+ 0% { opacity: 0; transform: translateX(var(--from, -200px)); }
214
+ 18%, 76% { opacity: 1; transform: translateX(0); }
215
+ 100% { opacity: 0; transform: translateX(var(--from, -200px)); }
216
+ }
217
+
218
+ /* 모일 곳은 꽃잎마다 다르다 — 가운데까지의 거리를 `--gx` · `--gy` 로 받는다 */
219
+ @keyframes hero-visual-unfold {
220
+ 0% { opacity: 0; transform: translate(var(--gx), var(--gy)) scale(.3); }
221
+ 18%, 76% { opacity: 1; transform: translate(0, 0) scale(1); }
222
+ 100% { opacity: 0; transform: translate(var(--gx), var(--gy)) scale(.3); }
223
+ }
224
+
225
+ /*
226
+ * **멈춰 세우기.** `motion="still"` 과 "움직임을 줄여 달라" 는 기기가 같은 자리에 선다.
227
+ *
228
+ * **들고 나는 것만 멈추면 모자란다** — 그 안의 그림들도 저마다 숨 쉬고 떠다니므로,
229
+ * 바깥만 멈추면 "멈춘 그림" 이 아니라 "제자리에서 꿈틀대는 그림" 이 된다.
230
+ *
231
+ * `!important` 가 붙은 까닭: 숨·떨림은 쪽마다 길이와 늦기가 달라 **인라인으로** 달려
232
+ * 있고, 인라인은 규칙보다 세다. 이것이 없으면 멈춤이 겉돈다.
233
+ *
234
+ * 멈출 때는 **다 선 모습**이라야 한다. 들어오는 틀의 0% 는 "아직 안 나온 모습"(크기 0,
235
+ * 투명)이라, 그냥 멈추면 **빈 자리**가 된다. 그래서 되돌려 둔다.
236
+ *
237
+ * 되돌리는 것은 **들고 나는 자리에만** 건다. 그림 전체에 `transform: none` 을 걸면
238
+ * 기울여 둔 필(`transform` 쓰임새)까지 펴져, 멈춘 모습이 디자인과 달라진다.
239
+ */
240
+ .hero-visual--still .hero-visual__svg,
241
+ .hero-visual--still .hero-visual__svg * {
242
+ animation: none !important;
243
+ }
244
+
245
+ .hero-visual--still .hero-visual__in {
246
+ opacity: 1;
247
+ transform: none;
248
+ }
249
+
250
+ /* 그어지는 선만 되돌린다 — 테의 사분면을 짚어 두는 `stroke-dashoffset` 까지 0 으로
251
+ 밀면, 멈춘 그림에서 **토막이 엉뚱한 자리**에 선다 */
252
+ .hero-visual--still .hero-visual__in--draw {
253
+ stroke-dashoffset: 0;
254
+ }
255
+
256
+ @media (prefers-reduced-motion: reduce) {
257
+ .hero-visual .hero-visual__svg,
258
+ .hero-visual .hero-visual__svg * {
259
+ animation: none !important;
260
+ }
261
+
262
+ .hero-visual .hero-visual__in {
263
+ opacity: 1;
264
+ transform: none;
265
+ }
266
+
267
+ .hero-visual .hero-visual__in--draw {
268
+ stroke-dashoffset: 0;
269
+ }
270
+ }
271
+
272
+ /* ── 그림마다 가진 제 움직임 ───────────────────────────────────────────────── */
273
+
274
+ @keyframes hero-visual-floaty {
275
+ 0%, 100% { transform: translateY(0); }
276
+ 50% { transform: translateY(-14px); }
277
+ }
278
+ @keyframes hero-visual-drift {
279
+ 0%, 100% { transform: translate(0, 0); }
280
+ 50% { transform: translate(10px, -18px); }
281
+ }
282
+ @keyframes hero-visual-breathe {
283
+ 0%, 100% { transform: scale(1); }
284
+ 50% { transform: scale(1.05); }
285
+ }
286
+ @keyframes hero-visual-pulse {
287
+ 0%, 100% { transform: scale(1); opacity: .9; }
288
+ 50% { transform: scale(1.06); opacity: 1; }
289
+ }
290
+ @keyframes hero-visual-approach {
291
+ 0%, 100% { transform: translateX(0); }
292
+ 50% { transform: translateX(-14px); }
293
+ }
294
+ @keyframes hero-visual-approach-r {
295
+ 0%, 100% { transform: translateX(0); }
296
+ 50% { transform: translateX(14px); }
297
+ }
298
+ /* 아홉 점이 저마다 깜빡인다 — 낱낱이 떨어진 소리가 하나씩 켜지는 것 */
299
+ @keyframes hero-visual-blink {
300
+ 0%, 70%, 100% { opacity: .25; }
301
+ 20%, 50% { opacity: 1; }
302
+ }
303
+
304
+
305
+ /*
306
+ * 고리 둘이 **서로 다른 길로** 조금씩 떠다닌다(사용자 지시 2026-11-09 — *"서로 다르게
307
+ * 위치가 움직여 졌으면 좋겠어"*). 길도 걸리는 시간도 달라, 둘 사이가 늘 조금씩 바뀐다.
308
+ *
309
+ * 폭이 10 안팎이다 — 반지름이 200 쯤이라 **스무 분의 일**. 더 크게 하면 꿰인 자리가
310
+ * 눈에 띄게 어긋난다.
311
+ */
312
+ @keyframes hero-visual-rove-a {
313
+ 0%, 100% { transform: translate(0, 0); }
314
+ 50% { transform: translate(-10px, 8px); }
315
+ }
316
+ @keyframes hero-visual-rove-b {
317
+ 0%, 100% { transform: translate(0, 0); }
318
+ 50% { transform: translate(12px, -9px); }
319
+ }
320
+
321
+ /*
322
+ * 고리가 제자리에서 한 바퀴 돈다.
323
+ *
324
+ * **꼴은 하나도 안 바뀐다** — 테는 제 중심을 축으로 돌면 저 자신에 포개진다. 바뀌는
325
+ * 것은 **색뿐**이다(그라데이션이 좌표 기준이라 테와 함께 안 돈다). 그래서 띠를 따라
326
+ * 빛깔이 흐르는 것으로 보인다.
327
+ *
328
+ * 끝이 시작과 같은 자리라 되풀이되는 데서 안 튄다.
329
+ */
330
+ @keyframes hero-visual-revolve {
331
+ 0% { transform: rotate(0deg); }
332
+ 100% { transform: rotate(360deg); }
333
+ }
334
+ @keyframes hero-visual-revolve-r {
335
+ 0% { transform: rotate(0deg); }
336
+ 100% { transform: rotate(-360deg); }
337
+ }
338
+
339
+ @keyframes hero-visual-sway {
340
+ 0%, 100% { transform: rotate(-6deg); }
341
+ 50% { transform: rotate(6deg); }
342
+ }
343
+
344
+ /* 블롭이 떠다니는 길 — 지금 랜딩(`LandingPage.css`)의 값 그대로다.
345
+ 큰 것이 덜 움직인다: 480 짜리가 26 이면 제 크기의 5%, 200 짜리가 24 면 12% 다. */
346
+ @keyframes hero-visual-blob-1 {
347
+ 0%, 100% { transform: translate(0, 0); }
348
+ 25% { transform: translate(10px, -16px); }
349
+ 50% { transform: translate(-8px, -26px); }
350
+ 75% { transform: translate(-14px, -10px); }
351
+ }
352
+ @keyframes hero-visual-blob-2 {
353
+ 0%, 100% { transform: translate(0, 0); }
354
+ 25% { transform: translate(-14px, 14px); }
355
+ 50% { transform: translate(-6px, 24px); }
356
+ 75% { transform: translate(12px, 10px); }
357
+ }
358
+
359
+ /*
360
+ * **블롭에서 번져 나가는 파동 고리.**
361
+ *
362
+ * 앱의 랜딩에서 떠 올 때는 `0%` 가 `opacity: .75` 였다. 그런데 이 틀은 4초마다 되풀이
363
+ * 되므로, **끝(0)에서 시작(0.75)으로 돌아올 때 툭 튄다** — 고리가 셋이고 시작이 엇갈려
364
+ * 있어 1.3초마다 한 번씩 깜빡이는 것으로 보였다(사용자 지시 2026-11-09 — *"파장색 링
365
+ * 아래에 뭐가 마구 깜빡이네?"* · 실측 Δ0.74).
366
+ *
367
+ * 번지기 시작할 때 **옅게 켜지도록** 고쳐 끝과 시작을 맞췄다.
368
+ */
369
+ @keyframes hero-visual-wave {
370
+ 0% { transform: scale(1); opacity: 0; }
371
+ 18% { opacity: .75; }
372
+ 100% { transform: scale(1.35); opacity: 0; }
373
+ }
374
+
375
+
376
+ /* 가운데로 모였다 펴진다 — 모일 곳이 꽃잎마다 달라 `--gx` · `--gy` 로 받는다 */
377
+ @keyframes hero-visual-gather {
378
+ 0%, 76% { transform: translate(0, 0); }
379
+ 83%, 88% { transform: translate(var(--gx), var(--gy)); }
380
+ 95%, 100% { transform: translate(0, 0); }
381
+ }
382
+
383
+ /* ── 겹침 ──────────────────────────────────────────────────────────────────
384
+ 겹친 자리가 **짙어져야** 렌즈·꽃잎으로 읽힌다. 반투명만으로는 겹친 데가 밝아진다. */
385
+ .hero-visual__lens,
386
+ .hero-visual__petals,
387
+ .hero-visual__discs,
388
+ .hero-visual__blades {
389
+ mix-blend-mode: multiply;
390
+ }
@@ -0,0 +1,102 @@
1
+ import { type CSSProperties } from 'react';
2
+ import './HeroVisual.css';
3
+ /**
4
+ * 히어로 비주얼의 꼴. 디자인 판(`Hero Visual Options`)의 번호가 아니라 **무엇인지로**
5
+ * 부른다 — 소비자 코드에 `variant="5i"` 라고 적히면 그 쪽만 보고는 무슨 그림인지 모른다.
6
+ * @public
7
+ */
8
+ export type HeroVisualVariant =
9
+ /** 지금 랜딩에 선 배경 — 큰 방울과 작은 방울, 번져 나가는 파동 고리 셋 */
10
+ 'blobs'
11
+ /** 블루에서 틸, 라임으로 가는 관이 고리를 그리며 흐른다 */
12
+ | 'ribbon'
13
+ /** 블러와 페이드로 겹친 구체가 천천히 떠다닌다 */
14
+ | 'spheres'
15
+ /** 네 코너가 하나씩 돋아 클로버를 이룬다 */
16
+ | 'clover'
17
+ /** 하나였던 필이 셋으로 갈라져 톤 단계로 쌓이고, 번갈아 흔들린다 */
18
+ | 'stackedPills'
19
+ /** 두꺼운 그라데이션 링 둘이 앞뒤로 겹치고 틀 밖으로 잘린다 */
20
+ | 'doubleRing'
21
+ /** 동심 원 넷이 가운데에서 차례로 번져 나간다 */
22
+ | 'concentric'
23
+ /** 두 방울이 겹쳐 하나로 붙는다 — 랜딩 배경과 같은 크기·자리·색 */
24
+ | 'metaball'
25
+ /** 점으로 이뤄진 동심원 파문 */
26
+ | 'dottedRipple'
27
+ /** 두 원이 겹쳐 렌즈가 된다 */
28
+ | 'vesica'
29
+ /** 납작한 반투명 원판이 위에서 아래로 쌓인다 */
30
+ | 'stackedDiscs'
31
+ /** 중심을 둘러싼 원 여섯이 숨 네 번마다 한 번 가운데로 모였다 펴진다 */
32
+ | 'flower'
33
+ /** 모난 데를 둥글린 네모 셋이 포개져 저마다 숨 쉰다 */
34
+ | 'squircles'
35
+ /** 점 아홉이 격자로 서서 하나씩 깜빡인다 */
36
+ | 'dotGrid'
37
+ /** 막대 넷이 층계처럼 키를 달리해 오르내린다 */
38
+ | 'stairs';
39
+ /** @public */
40
+ export interface HeroVisualProps {
41
+ /** 어떤 그림인가 */
42
+ variant: HeroVisualVariant;
43
+ /**
44
+ * `'loop'`(기본) — 등장 · 머묾 · 퇴장을 되풀이한다.
45
+ *
46
+ * `'once'` — **한 바퀴만 돌고 다 나간 채로 선다.** 꼴을 차례로 갈아 끼울 때 쓴다 —
47
+ * 되풀이되는 동안에는 조각마다 차례가 달라 **모두가 함께 비는 때가 없어**, 갈아
48
+ * 끼우면 사라지는 중인 조각이 잘린다. 다 나간 때는 `onCycleEnd` 가 알려 준다.
49
+ *
50
+ * `'still'` — **멈춰 선 한 장**. 한 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다.
51
+ *
52
+ * 움직임을 줄여 달라고 한 기기에서는 `'loop'`·`'once'` 라도 `'still'` 처럼 선다.
53
+ */
54
+ motion?: 'loop' | 'once' | 'still';
55
+ /**
56
+ * `motion="once"` 에서 **가장 늦은 조각까지 다 나간 뒤** 한 번 불린다.
57
+ *
58
+ * 다른 `motion` 에서는 안 불린다 — 되풀이되는 동안에는 "다 나갔다" 는 때가 없다.
59
+ *
60
+ * 움직임이 멎은 자리(움직임 줄이기 · 숨은 탭)에서도 **반드시 한 번은 불린다** —
61
+ * 안 그러면 이것으로 다음 꼴을 세우는 쪽이 첫 꼴에서 멈춘 채 조용해진다.
62
+ */
63
+ onCycleEnd?: () => void;
64
+ /** 한 바퀴에 걸리는 시간(ms). 기본 9000 */
65
+ cycleMs?: number;
66
+ /**
67
+ * 낭독기에 읽힐 이름. **안 주면 장식으로 보고 숨긴다**(`aria-hidden`) — 이 그림들은
68
+ * 글이 따로 있는 히어로의 배경이라, 이름을 읽어 주면 같은 말을 두 번 듣는다.
69
+ */
70
+ label?: string;
71
+ className?: string;
72
+ style?: CSSProperties;
73
+ }
74
+ /** 꼴의 이름들 — 놀이터가 전부를 훑을 때 쓴다 @public */
75
+ export declare const HERO_VISUAL_VARIANTS: HeroVisualVariant[];
76
+ /**
77
+ * **히어로 비주얼** — 랜딩 머리에 세우는 그림.
78
+ *
79
+ * 디자인 판(claude.ai/design 의 `Hero Visual Options` · `말귀 심볼 확장`)에서 고른 꼴을
80
+ * 한 컴포넌트가 쥔다. `variant` 하나만 바꾸면 그림이 바뀐다.
81
+ *
82
+ * **한 바퀴는 등장 · 머묾 · 퇴장이다.** 차례로 갈아 끼우려면 `motion="once"` 로 두고
83
+ * `onCycleEnd` 를 받는다 — 되풀이되는 동안에는 조각마다 차례가 달라 **모두가 함께
84
+ * 비는 때가 없어서**, 아무 때나 갈아 끼우면 사라지는 중인 조각이 잘린다.
85
+ * 머무는 동안이 한 바퀴의 6할이라, 그림이 제 꼴로
86
+ * 서 있는 시간이 가장 길다. `motion="still"` 이면 **멈춰 선 한 장**이 되는데, 이때는 한
87
+ * 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다 — 바깥만 멈추면 "멈춘 그림" 이 아니라
88
+ * "제자리에서 꿈틀대는 그림" 이 된다.
89
+ *
90
+ * **크기는 쓰는 쪽이 정한다.** 가로를 100% 로 채우고 세로는 제 비율대로 따라오므로,
91
+ * 감싸는 자리의 폭만 정해 주면 된다.
92
+ *
93
+ * ```tsx
94
+ * <div style={{ width: 520 }}>
95
+ * <HeroVisual variant="blobs" />
96
+ * </div>
97
+ * <HeroVisual variant="clover" motion="still" />
98
+ * ```
99
+ *
100
+ * @public
101
+ */
102
+ export default function HeroVisual({ variant, motion, cycleMs, label, className, style, onCycleEnd, }: HeroVisualProps): import("react").JSX.Element;