@ihabdevteam/core 0.423.0 → 0.424.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 +48 -0
- 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.cjs.js +186 -186
- package/dist/ihabdevteam-core.d.ts +90 -1
- package/dist/packages/core/src/components/HeroVisual.css +307 -0
- package/dist/packages/core/src/components/HeroVisual.d.ts +79 -0
- package/dist/packages/core/src/components/HeroVisual.js +250 -0
- 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/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
|
@@ -2110,7 +2110,7 @@ export declare function copyText(text: string): Promise<boolean>;
|
|
|
2110
2110
|
*
|
|
2111
2111
|
* 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
|
|
2112
2112
|
*/
|
|
2113
|
-
export declare const CORE_VERSION = "0.
|
|
2113
|
+
export declare const CORE_VERSION = "0.424.0";
|
|
2114
2114
|
|
|
2115
2115
|
/** @public */
|
|
2116
2116
|
declare const coreDefault: Record<string, unknown>;
|
|
@@ -3396,6 +3396,8 @@ export declare function getWordPool(): WordPool | null;
|
|
|
3396
3396
|
* 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
|
|
3397
3397
|
* (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
|
|
3398
3398
|
* 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
|
|
3399
|
+
*
|
|
3400
|
+
* 사전이 배열을 안 주면 한국어 원문으로 물러선다 — 빈 줄을 띄우지 않는다((205)).
|
|
3399
3401
|
*/
|
|
3400
3402
|
export declare function gradeDescriptions(t: TFunction): string[];
|
|
3401
3403
|
|
|
@@ -3459,6 +3461,87 @@ export declare function Header({ activeKey, onChange, items, malgwiItems: _malgw
|
|
|
3459
3461
|
scrollContainer?: string | RefObject<HTMLElement | null>;
|
|
3460
3462
|
}): JSX.Element;
|
|
3461
3463
|
|
|
3464
|
+
/** 꼴의 이름들 — 놀이터가 전부를 훑을 때 쓴다 @public */
|
|
3465
|
+
export declare const HERO_VISUAL_VARIANTS: HeroVisualVariant[];
|
|
3466
|
+
|
|
3467
|
+
/**
|
|
3468
|
+
* **히어로 비주얼** — 랜딩 머리에 세우는 그림.
|
|
3469
|
+
*
|
|
3470
|
+
* 디자인 판(claude.ai/design 의 `Hero Visual Options`)에서 고른 꼴 열셋을 한 컴포넌트가
|
|
3471
|
+
* 쥔다. `variant` 하나만 바꾸면 그림이 바뀐다.
|
|
3472
|
+
*
|
|
3473
|
+
* **한 바퀴는 등장 · 머묾 · 퇴장이다.** 머무는 동안이 한 바퀴의 6할이라, 그림이 제 꼴로
|
|
3474
|
+
* 서 있는 시간이 가장 길다. `motion="still"` 이면 **멈춰 선 한 장**이 되는데, 이때는 한
|
|
3475
|
+
* 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다 — 바깥만 멈추면 "멈춘 그림" 이 아니라
|
|
3476
|
+
* "제자리에서 꿈틀대는 그림" 이 된다.
|
|
3477
|
+
*
|
|
3478
|
+
* **크기는 쓰는 쪽이 정한다.** 가로를 100% 로 채우고 세로는 제 비율대로 따라오므로,
|
|
3479
|
+
* 감싸는 자리의 폭만 정해 주면 된다.
|
|
3480
|
+
*
|
|
3481
|
+
* ```tsx
|
|
3482
|
+
* <div style={{ width: 520 }}>
|
|
3483
|
+
* <HeroVisual variant="blobs" />
|
|
3484
|
+
* </div>
|
|
3485
|
+
* <HeroVisual variant="clover" motion="still" />
|
|
3486
|
+
* ```
|
|
3487
|
+
*
|
|
3488
|
+
* @public
|
|
3489
|
+
*/
|
|
3490
|
+
export declare function HeroVisual({ variant, motion, cycleMs, label, className, style, }: HeroVisualProps): JSX.Element;
|
|
3491
|
+
|
|
3492
|
+
/** @public */
|
|
3493
|
+
export declare interface HeroVisualProps {
|
|
3494
|
+
/** 어떤 그림인가 */
|
|
3495
|
+
variant: HeroVisualVariant;
|
|
3496
|
+
/**
|
|
3497
|
+
* `'loop'`(기본) — 등장 · 머묾 · 퇴장을 되풀이한다.
|
|
3498
|
+
* `'still'` — **멈춰 선 한 장**. 한 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다.
|
|
3499
|
+
*
|
|
3500
|
+
* 움직임을 줄여 달라고 한 기기에서는 `'loop'` 라도 `'still'` 처럼 선다.
|
|
3501
|
+
*/
|
|
3502
|
+
motion?: 'loop' | 'still';
|
|
3503
|
+
/** 한 바퀴에 걸리는 시간(ms). 기본 9000 */
|
|
3504
|
+
cycleMs?: number;
|
|
3505
|
+
/**
|
|
3506
|
+
* 낭독기에 읽힐 이름. **안 주면 장식으로 보고 숨긴다**(`aria-hidden`) — 이 그림들은
|
|
3507
|
+
* 글이 따로 있는 히어로의 배경이라, 이름을 읽어 주면 같은 말을 두 번 듣는다.
|
|
3508
|
+
*/
|
|
3509
|
+
label?: string;
|
|
3510
|
+
className?: string;
|
|
3511
|
+
style?: CSSProperties;
|
|
3512
|
+
}
|
|
3513
|
+
|
|
3514
|
+
/**
|
|
3515
|
+
* 히어로 비주얼의 꼴. 디자인 판(`Hero Visual Options`)의 번호가 아니라 **무엇인지로**
|
|
3516
|
+
* 부른다 — 소비자 코드에 `variant="5i"` 라고 적히면 그 쪽만 보고는 무슨 그림인지 모른다.
|
|
3517
|
+
* @public
|
|
3518
|
+
*/
|
|
3519
|
+
export declare type HeroVisualVariant =
|
|
3520
|
+
/** 지금 랜딩에 선 배경 — 큰 방울과 작은 방울, 번져 나가는 파동 고리 셋 */
|
|
3521
|
+
'blobs'
|
|
3522
|
+
/** 블루에서 틸, 라임으로 가는 관이 고리를 그리며 흐른다 */
|
|
3523
|
+
| 'ribbon'
|
|
3524
|
+
/** 블러와 페이드로 겹친 구체가 천천히 떠다닌다 */
|
|
3525
|
+
| 'spheres'
|
|
3526
|
+
/** 네 코너가 하나씩 돋아 클로버를 이룬다 */
|
|
3527
|
+
| 'clover'
|
|
3528
|
+
/** 하나였던 필이 셋으로 갈라져 톤 단계로 쌓이고, 번갈아 흔들린다 */
|
|
3529
|
+
| 'stackedPills'
|
|
3530
|
+
/** 두꺼운 그라데이션 링 둘이 앞뒤로 겹치고 틀 밖으로 잘린다 */
|
|
3531
|
+
| 'doubleRing'
|
|
3532
|
+
/** 동심 원 넷이 가운데에서 차례로 번져 나간다 */
|
|
3533
|
+
| 'concentric'
|
|
3534
|
+
/** 두 방울이 겹쳐 하나로 붙는다 — 랜딩 배경과 같은 크기·자리·색 */
|
|
3535
|
+
| 'metaball'
|
|
3536
|
+
/** 점으로 이뤄진 동심원 파문 */
|
|
3537
|
+
| 'dottedRipple'
|
|
3538
|
+
/** 두 원이 겹쳐 렌즈가 된다 */
|
|
3539
|
+
| 'vesica'
|
|
3540
|
+
/** 납작한 반투명 원판이 위에서 아래로 쌓인다 */
|
|
3541
|
+
| 'stackedDiscs'
|
|
3542
|
+
/** 중심을 둘러싼 원 여섯이 숨 네 번마다 한 번 가운데로 모였다 펴진다 */
|
|
3543
|
+
| 'flower';
|
|
3544
|
+
|
|
3462
3545
|
/** @public */
|
|
3463
3546
|
export declare interface I18nContextValue {
|
|
3464
3547
|
locale: string;
|
|
@@ -11573,6 +11656,12 @@ export declare function useWordTrainingDataGeneration(types: WordTrainingType[],
|
|
|
11573
11656
|
generating: boolean;
|
|
11574
11657
|
};
|
|
11575
11658
|
|
|
11659
|
+
/**
|
|
11660
|
+
* 단어 훈련 그룹별 필터 상태.
|
|
11661
|
+
* @param groupKey 그룹 식별자 (localStorage 키 및 상태 격리에 사용)
|
|
11662
|
+
* @param caps 그룹이 노출할 설정 (난이도/단어구성). 제외 필터는 항상 노출.
|
|
11663
|
+
* @public
|
|
11664
|
+
*/
|
|
11576
11665
|
export declare function useWordTrainingFilter(groupKey: string, caps: WordTrainingFilterCaps, opts?: {
|
|
11577
11666
|
resetOnMount?: boolean;
|
|
11578
11667
|
resetKey?: string;
|
|
@@ -0,0 +1,307 @@
|
|
|
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
|
+
|
|
44
|
+
/* 블롭에서 번져 나가는 고리 — 끊임없이 커졌다 사라지므로 미리 일러둔다 */
|
|
45
|
+
.hero-visual__ring {
|
|
46
|
+
will-change: transform, opacity;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/*
|
|
50
|
+
* **들고 나는 자리.**
|
|
51
|
+
*
|
|
52
|
+
* 어느 틀로 드는지는 클래스가, **차례**는 `--hero-visual-turn` 이 정한다.
|
|
53
|
+
* JS 가 `animation` 같은 **표준 속성에 `var()` 를 인라인으로 주면 jsdom 이 그 값을
|
|
54
|
+
* 버려서**, 시험이 이 자리를 아예 못 본다(`test/inlineVarIsInvisible1020`). 사용자
|
|
55
|
+
* 속성으로 넘기고 받는 일은 CSS 가 한다 — 그 꼴은 jsdom 이 간직한다.
|
|
56
|
+
*/
|
|
57
|
+
.hero-visual__in {
|
|
58
|
+
animation-duration: var(--hero-visual-cycle);
|
|
59
|
+
animation-timing-function: ease-in-out;
|
|
60
|
+
animation-iteration-count: infinite;
|
|
61
|
+
/* 제 차례 전에는 0% 의 모습(= 아직 안 나온 모습)으로 둔다 — 없으면 기다리는 동안
|
|
62
|
+
다 그려진 채로 서 있다가 갑자기 사라진다 */
|
|
63
|
+
animation-fill-mode: backwards;
|
|
64
|
+
animation-delay: calc(var(--hero-visual-cycle) * var(--hero-visual-turn, 0));
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
.hero-visual__in--bloom { animation-name: hero-visual-bloom; }
|
|
68
|
+
.hero-visual__in--draw { animation-name: hero-visual-draw; }
|
|
69
|
+
.hero-visual__in--fade { animation-name: hero-visual-fade; }
|
|
70
|
+
.hero-visual__in--settle { animation-name: hero-visual-settle; }
|
|
71
|
+
.hero-visual__in--pop { animation-name: hero-visual-pop; }
|
|
72
|
+
.hero-visual__in--fan { animation-name: hero-visual-fan; }
|
|
73
|
+
.hero-visual__in--meet { animation-name: hero-visual-meet; }
|
|
74
|
+
.hero-visual__in--unfold { animation-name: hero-visual-unfold; }
|
|
75
|
+
|
|
76
|
+
/*
|
|
77
|
+
* ── 한 바퀴 — 등장 · 머묾 · 퇴장 ──────────────────────────────────────────────
|
|
78
|
+
*
|
|
79
|
+
* **하나를 돌려 쓰지 않는다**(사용자 지시 2026-11-09 — *"그냥 스르륵 나오는건 재미없잖아
|
|
80
|
+
* 공통으로 사용하지말고"*). 꼴마다 제 몸에 맞는 길로 들고 난다 —
|
|
81
|
+
*
|
|
82
|
+
* · 선은 **제 손으로 그어졌다 지워지고**(`draw`)
|
|
83
|
+
* · 꽃잎·점·원판은 **톡 튀어나오고**(`pop`)
|
|
84
|
+
* · 필은 **하나였다가 셋으로 갈라지고**(`fan`)
|
|
85
|
+
* · 구체는 **제자리에서 오므라졌다 번지고**(`settle`)
|
|
86
|
+
* · 방울·렌즈는 **가운데에 겹쳐 있다 갈라지고**(`meet`)
|
|
87
|
+
* · 꽃은 **가운데에 모였다 펴진다**(`unfold`)
|
|
88
|
+
*
|
|
89
|
+
* **머무는 동안이 한 바퀴의 6할**이다. 들고 나는 데 오래 걸리면 그림이 제 꼴로 서 있는
|
|
90
|
+
* 시간이 짧아져, 무엇을 보여 주려던 것인지가 흐려진다.
|
|
91
|
+
*
|
|
92
|
+
* **끝난 자리가 시작한 자리와 같다**(사용자 지시 2026-11-09 — *"애니메이션 끊기는
|
|
93
|
+
* 부분이 있는데 끊어지지 않게"*). 나왔던 길로 되짚어 들어가므로 100% 와 0% 의 모습이
|
|
94
|
+
* 한 치도 안 다르다 — 되풀이되는 자리에서 **튀는 데가 없다.**
|
|
95
|
+
*
|
|
96
|
+
* 전에는 커지며 사라졌다가(1.3) 점에서 다시 나왔다(0). 사라진 뒤라 안 보이긴 해도,
|
|
97
|
+
* 꺼지는 쪽과 켜지는 쪽의 **크기가 달라** 그 사이에 멈칫하는 틈이 생겼다. 머무는 뒤에
|
|
98
|
+
* 비는 마디(90~100%)도 걷었다 — 퇴장이 100% 에서 끝나고 바로 다음 등장이 선다.
|
|
99
|
+
*
|
|
100
|
+
* 조각이 여럿인 꼴은 `--hero-visual-in` 으로 **차례를 매긴다**(한 바퀴에 대한 비율).
|
|
101
|
+
* `backwards` 를 붙여, 제 차례가 오기 전에는 0% 의 모습(= 아직 안 나온 모습)으로 둔다 —
|
|
102
|
+
* 안 붙이면 차례를 기다리는 동안 **다 그려진 채로** 서 있다가 갑자기 사라진다.
|
|
103
|
+
*/
|
|
104
|
+
|
|
105
|
+
@keyframes hero-visual-bloom {
|
|
106
|
+
0% { opacity: 0; transform: scale(.2); }
|
|
107
|
+
10% { opacity: 1; transform: scale(1.04); }
|
|
108
|
+
14% { transform: scale(1); }
|
|
109
|
+
76% { opacity: 1; transform: scale(1); }
|
|
110
|
+
100% { opacity: 0; transform: scale(.2); }
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/* 선이 제 손으로 그어졌다 **그어 온 길을 되짚어** 걷힌다. `pathLength="1"` 이라
|
|
114
|
+
길이가 달라도 같은 박자로 간다 */
|
|
115
|
+
@keyframes hero-visual-draw {
|
|
116
|
+
0% { stroke-dashoffset: 1; }
|
|
117
|
+
26%, 76% { stroke-dashoffset: 0; }
|
|
118
|
+
100% { stroke-dashoffset: 1; }
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
@keyframes hero-visual-fade {
|
|
122
|
+
0% { opacity: 0; }
|
|
123
|
+
26%, 76% { opacity: 1; }
|
|
124
|
+
100% { opacity: 0; }
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/* 제자리에서 오므라졌다 번진다 — 구체처럼 테가 흐린 것은 **자리를 옮기면** 번진 자락이
|
|
128
|
+
상자 밖에서 잘려 반달이 된다 */
|
|
129
|
+
@keyframes hero-visual-settle {
|
|
130
|
+
0% { opacity: 0; transform: scale(.78); }
|
|
131
|
+
14%, 76% { opacity: 1; transform: scale(1); }
|
|
132
|
+
100% { opacity: 0; transform: scale(.78); }
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/* 톡 튀어나왔다 **다시 점으로** 줄어든다 */
|
|
136
|
+
@keyframes hero-visual-pop {
|
|
137
|
+
0% { opacity: 0; transform: scale(0); }
|
|
138
|
+
11% { opacity: 1; transform: scale(1.08); }
|
|
139
|
+
15%, 76% { opacity: 1; transform: scale(1); }
|
|
140
|
+
100% { opacity: 0; transform: scale(0); }
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/*
|
|
144
|
+
* **하나였다가 여럿으로 갈라진다**(사용자 지시 2026-11-09 — *"1개였다가 4개로 배치되는
|
|
145
|
+
* 방식으로 나오게 해줘"*).
|
|
146
|
+
*
|
|
147
|
+
* 장들이 **같은 자리에 같은 각으로** 겹쳐 있다가(`--dy` 만큼 가운데로 모이고 각은 0),
|
|
148
|
+
* 제 자리와 제 기울기로 흩어진다. 모였을 때 한 치도 안 어긋나야 **하나로 보인다** —
|
|
149
|
+
* 그래서 각까지 여기서 돌린다(`--a`).
|
|
150
|
+
*
|
|
151
|
+
* 전에는 좌우로 펴지게 했는데(`scaleX`), 납작한 막대가 가로로만 늘면 **Y 축을 도는
|
|
152
|
+
* 것처럼** 보여 2D 가 깨졌다(사용자 지시 — *"y 축 로테이션 별로야 2d 공간을 유지"*).
|
|
153
|
+
*/
|
|
154
|
+
@keyframes hero-visual-fan {
|
|
155
|
+
0% { opacity: 0; transform: translateY(var(--dy, 0)) rotate(0deg) scale(.96); }
|
|
156
|
+
9% { opacity: 1; transform: translateY(var(--dy, 0)) rotate(0deg) scale(1); }
|
|
157
|
+
26%, 76% { opacity: 1; transform: translateY(0) rotate(var(--a, 0deg)) scale(1); }
|
|
158
|
+
93% { opacity: 1; transform: translateY(var(--dy, 0)) rotate(0deg) scale(1); }
|
|
159
|
+
100% { opacity: 0; transform: translateY(var(--dy, 0)) rotate(0deg) scale(.96); }
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/*
|
|
163
|
+
* **안쪽에서 와 제자리로 간다** — `--from` 은 가운데 쪽으로의 거리다(사용자 지시
|
|
164
|
+
* 2026-11-09 — *"안쪽에서 오게 고쳐줘"*).
|
|
165
|
+
*
|
|
166
|
+
* 처음에는 틀 **밖에서** 날아오게 했는데, 상자를 쉬는 자리에 바짝 맞춰 둔 탓에 그
|
|
167
|
+
* 여정이 상자 밖이라 **들어오는 동안 반달로 잘렸다**(`s4 베시카` 실측). 상자를 넓히면
|
|
168
|
+
* 쉴 때 빈 자리가 생기므로, 여정을 안쪽으로 접었다.
|
|
169
|
+
*/
|
|
170
|
+
@keyframes hero-visual-meet {
|
|
171
|
+
0% { opacity: 0; transform: translateX(var(--from, -200px)); }
|
|
172
|
+
18%, 76% { opacity: 1; transform: translateX(0); }
|
|
173
|
+
100% { opacity: 0; transform: translateX(var(--from, -200px)); }
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/* 모일 곳은 꽃잎마다 다르다 — 가운데까지의 거리를 `--gx` · `--gy` 로 받는다 */
|
|
177
|
+
@keyframes hero-visual-unfold {
|
|
178
|
+
0% { opacity: 0; transform: translate(var(--gx), var(--gy)) scale(.3); }
|
|
179
|
+
18%, 76% { opacity: 1; transform: translate(0, 0) scale(1); }
|
|
180
|
+
100% { opacity: 0; transform: translate(var(--gx), var(--gy)) scale(.3); }
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/*
|
|
184
|
+
* **멈춰 세우기.** `motion="still"` 과 "움직임을 줄여 달라" 는 기기가 같은 자리에 선다.
|
|
185
|
+
*
|
|
186
|
+
* **들고 나는 것만 멈추면 모자란다** — 그 안의 그림들도 저마다 숨 쉬고 떠다니므로,
|
|
187
|
+
* 바깥만 멈추면 "멈춘 그림" 이 아니라 "제자리에서 꿈틀대는 그림" 이 된다.
|
|
188
|
+
*
|
|
189
|
+
* `!important` 가 붙은 까닭: 숨·떨림은 쪽마다 길이와 늦기가 달라 **인라인으로** 달려
|
|
190
|
+
* 있고, 인라인은 규칙보다 세다. 이것이 없으면 멈춤이 겉돈다.
|
|
191
|
+
*
|
|
192
|
+
* 멈출 때는 **다 선 모습**이라야 한다. 들어오는 틀의 0% 는 "아직 안 나온 모습"(크기 0,
|
|
193
|
+
* 투명)이라, 그냥 멈추면 **빈 자리**가 된다. 그래서 되돌려 둔다.
|
|
194
|
+
*
|
|
195
|
+
* 되돌리는 것은 **들고 나는 자리에만** 건다. 그림 전체에 `transform: none` 을 걸면
|
|
196
|
+
* 기울여 둔 필(`transform` 쓰임새)까지 펴져, 멈춘 모습이 디자인과 달라진다.
|
|
197
|
+
*/
|
|
198
|
+
.hero-visual--still .hero-visual__svg,
|
|
199
|
+
.hero-visual--still .hero-visual__svg * {
|
|
200
|
+
animation: none !important;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
.hero-visual--still .hero-visual__in {
|
|
204
|
+
opacity: 1;
|
|
205
|
+
transform: none;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/* 그어지는 선만 되돌린다 — 테의 사분면을 짚어 두는 `stroke-dashoffset` 까지 0 으로
|
|
209
|
+
밀면, 멈춘 그림에서 **토막이 엉뚱한 자리**에 선다 */
|
|
210
|
+
.hero-visual--still .hero-visual__in--draw {
|
|
211
|
+
stroke-dashoffset: 0;
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
@media (prefers-reduced-motion: reduce) {
|
|
215
|
+
.hero-visual .hero-visual__svg,
|
|
216
|
+
.hero-visual .hero-visual__svg * {
|
|
217
|
+
animation: none !important;
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
.hero-visual .hero-visual__in {
|
|
221
|
+
opacity: 1;
|
|
222
|
+
transform: none;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
.hero-visual .hero-visual__in--draw {
|
|
226
|
+
stroke-dashoffset: 0;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/* ── 그림마다 가진 제 움직임 ───────────────────────────────────────────────── */
|
|
231
|
+
|
|
232
|
+
@keyframes hero-visual-floaty {
|
|
233
|
+
0%, 100% { transform: translateY(0); }
|
|
234
|
+
50% { transform: translateY(-14px); }
|
|
235
|
+
}
|
|
236
|
+
@keyframes hero-visual-drift {
|
|
237
|
+
0%, 100% { transform: translate(0, 0); }
|
|
238
|
+
50% { transform: translate(10px, -18px); }
|
|
239
|
+
}
|
|
240
|
+
@keyframes hero-visual-breathe {
|
|
241
|
+
0%, 100% { transform: scale(1); }
|
|
242
|
+
50% { transform: scale(1.05); }
|
|
243
|
+
}
|
|
244
|
+
@keyframes hero-visual-pulse {
|
|
245
|
+
0%, 100% { transform: scale(1); opacity: .9; }
|
|
246
|
+
50% { transform: scale(1.06); opacity: 1; }
|
|
247
|
+
}
|
|
248
|
+
@keyframes hero-visual-approach {
|
|
249
|
+
0%, 100% { transform: translateX(0); }
|
|
250
|
+
50% { transform: translateX(-14px); }
|
|
251
|
+
}
|
|
252
|
+
@keyframes hero-visual-approach-r {
|
|
253
|
+
0%, 100% { transform: translateX(0); }
|
|
254
|
+
50% { transform: translateX(14px); }
|
|
255
|
+
}
|
|
256
|
+
@keyframes hero-visual-sway {
|
|
257
|
+
0%, 100% { transform: rotate(-6deg); }
|
|
258
|
+
50% { transform: rotate(6deg); }
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/* 블롭이 떠다니는 길 — 지금 랜딩(`LandingPage.css`)의 값 그대로다.
|
|
262
|
+
큰 것이 덜 움직인다: 480 짜리가 26 이면 제 크기의 5%, 200 짜리가 24 면 12% 다. */
|
|
263
|
+
@keyframes hero-visual-blob-1 {
|
|
264
|
+
0%, 100% { transform: translate(0, 0); }
|
|
265
|
+
25% { transform: translate(10px, -16px); }
|
|
266
|
+
50% { transform: translate(-8px, -26px); }
|
|
267
|
+
75% { transform: translate(-14px, -10px); }
|
|
268
|
+
}
|
|
269
|
+
@keyframes hero-visual-blob-2 {
|
|
270
|
+
0%, 100% { transform: translate(0, 0); }
|
|
271
|
+
25% { transform: translate(-14px, 14px); }
|
|
272
|
+
50% { transform: translate(-6px, 24px); }
|
|
273
|
+
75% { transform: translate(12px, 10px); }
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
/*
|
|
277
|
+
* **블롭에서 번져 나가는 파동 고리.**
|
|
278
|
+
*
|
|
279
|
+
* 앱의 랜딩에서 떠 올 때는 `0%` 가 `opacity: .75` 였다. 그런데 이 틀은 4초마다 되풀이
|
|
280
|
+
* 되므로, **끝(0)에서 시작(0.75)으로 돌아올 때 툭 튄다** — 고리가 셋이고 시작이 엇갈려
|
|
281
|
+
* 있어 1.3초마다 한 번씩 깜빡이는 것으로 보였다(사용자 지시 2026-11-09 — *"파장색 링
|
|
282
|
+
* 아래에 뭐가 마구 깜빡이네?"* · 실측 Δ0.74).
|
|
283
|
+
*
|
|
284
|
+
* 번지기 시작할 때 **옅게 켜지도록** 고쳐 끝과 시작을 맞췄다.
|
|
285
|
+
*/
|
|
286
|
+
@keyframes hero-visual-wave {
|
|
287
|
+
0% { transform: scale(1); opacity: 0; }
|
|
288
|
+
18% { opacity: .75; }
|
|
289
|
+
100% { transform: scale(1.35); opacity: 0; }
|
|
290
|
+
}
|
|
291
|
+
|
|
292
|
+
|
|
293
|
+
/* 가운데로 모였다 펴진다 — 모일 곳이 꽃잎마다 달라 `--gx` · `--gy` 로 받는다 */
|
|
294
|
+
@keyframes hero-visual-gather {
|
|
295
|
+
0%, 76% { transform: translate(0, 0); }
|
|
296
|
+
83%, 88% { transform: translate(var(--gx), var(--gy)); }
|
|
297
|
+
95%, 100% { transform: translate(0, 0); }
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
/* ── 겹침 ──────────────────────────────────────────────────────────────────
|
|
301
|
+
겹친 자리가 **짙어져야** 렌즈·꽃잎으로 읽힌다. 반투명만으로는 겹친 데가 밝아진다. */
|
|
302
|
+
.hero-visual__lens,
|
|
303
|
+
.hero-visual__petals,
|
|
304
|
+
.hero-visual__discs,
|
|
305
|
+
.hero-visual__blades {
|
|
306
|
+
mix-blend-mode: multiply;
|
|
307
|
+
}
|
|
@@ -0,0 +1,79 @@
|
|
|
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
|
+
/** @public */
|
|
34
|
+
export interface HeroVisualProps {
|
|
35
|
+
/** 어떤 그림인가 */
|
|
36
|
+
variant: HeroVisualVariant;
|
|
37
|
+
/**
|
|
38
|
+
* `'loop'`(기본) — 등장 · 머묾 · 퇴장을 되풀이한다.
|
|
39
|
+
* `'still'` — **멈춰 선 한 장**. 한 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다.
|
|
40
|
+
*
|
|
41
|
+
* 움직임을 줄여 달라고 한 기기에서는 `'loop'` 라도 `'still'` 처럼 선다.
|
|
42
|
+
*/
|
|
43
|
+
motion?: 'loop' | 'still';
|
|
44
|
+
/** 한 바퀴에 걸리는 시간(ms). 기본 9000 */
|
|
45
|
+
cycleMs?: number;
|
|
46
|
+
/**
|
|
47
|
+
* 낭독기에 읽힐 이름. **안 주면 장식으로 보고 숨긴다**(`aria-hidden`) — 이 그림들은
|
|
48
|
+
* 글이 따로 있는 히어로의 배경이라, 이름을 읽어 주면 같은 말을 두 번 듣는다.
|
|
49
|
+
*/
|
|
50
|
+
label?: string;
|
|
51
|
+
className?: string;
|
|
52
|
+
style?: CSSProperties;
|
|
53
|
+
}
|
|
54
|
+
/** 꼴의 이름들 — 놀이터가 전부를 훑을 때 쓴다 @public */
|
|
55
|
+
export declare const HERO_VISUAL_VARIANTS: HeroVisualVariant[];
|
|
56
|
+
/**
|
|
57
|
+
* **히어로 비주얼** — 랜딩 머리에 세우는 그림.
|
|
58
|
+
*
|
|
59
|
+
* 디자인 판(claude.ai/design 의 `Hero Visual Options`)에서 고른 꼴 열셋을 한 컴포넌트가
|
|
60
|
+
* 쥔다. `variant` 하나만 바꾸면 그림이 바뀐다.
|
|
61
|
+
*
|
|
62
|
+
* **한 바퀴는 등장 · 머묾 · 퇴장이다.** 머무는 동안이 한 바퀴의 6할이라, 그림이 제 꼴로
|
|
63
|
+
* 서 있는 시간이 가장 길다. `motion="still"` 이면 **멈춰 선 한 장**이 되는데, 이때는 한
|
|
64
|
+
* 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다 — 바깥만 멈추면 "멈춘 그림" 이 아니라
|
|
65
|
+
* "제자리에서 꿈틀대는 그림" 이 된다.
|
|
66
|
+
*
|
|
67
|
+
* **크기는 쓰는 쪽이 정한다.** 가로를 100% 로 채우고 세로는 제 비율대로 따라오므로,
|
|
68
|
+
* 감싸는 자리의 폭만 정해 주면 된다.
|
|
69
|
+
*
|
|
70
|
+
* ```tsx
|
|
71
|
+
* <div style={{ width: 520 }}>
|
|
72
|
+
* <HeroVisual variant="blobs" />
|
|
73
|
+
* </div>
|
|
74
|
+
* <HeroVisual variant="clover" motion="still" />
|
|
75
|
+
* ```
|
|
76
|
+
*
|
|
77
|
+
* @public
|
|
78
|
+
*/
|
|
79
|
+
export default function HeroVisual({ variant, motion, cycleMs, label, className, style, }: HeroVisualProps): import("react").JSX.Element;
|