@ihabdevteam/core 0.424.0 → 0.427.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 (73) hide show
  1. package/CHANGELOG.md +1185 -0
  2. package/README.md +9 -4
  3. package/dist/components.cjs.js +178 -173
  4. package/dist/components.esm.css +3 -3
  5. package/dist/hooks.cjs.js +5 -5
  6. package/dist/i18n.cjs.js +3 -3
  7. package/dist/ihabdevteam-core-tokens.css +1 -1
  8. package/dist/ihabdevteam-core.cjs.js +190 -185
  9. package/dist/ihabdevteam-core.css +1 -1
  10. package/dist/ihabdevteam-core.d.ts +156 -17
  11. package/dist/packages/core/src/components/BarChart.css +13 -0
  12. package/dist/packages/core/src/components/BarChart.js +21 -1
  13. package/dist/packages/core/src/components/BulkBar.css +6 -2
  14. package/dist/packages/core/src/components/DatePicker.d.ts +17 -1
  15. package/dist/packages/core/src/components/DatePicker.js +9 -2
  16. package/dist/packages/core/src/components/Dropdown.js +32 -8
  17. package/dist/packages/core/src/components/FileUpload.js +1 -1
  18. package/dist/packages/core/src/components/HeroVisual.css +93 -10
  19. package/dist/packages/core/src/components/HeroVisual.d.ts +30 -7
  20. package/dist/packages/core/src/components/HeroVisual.js +221 -36
  21. package/dist/packages/core/src/components/Landing/Landing.css +8 -2
  22. package/dist/packages/core/src/components/Landing/LandingCard.js +1 -1
  23. package/dist/packages/core/src/components/PanelRow.d.ts +8 -0
  24. package/dist/packages/core/src/components/PanelRow.js +2 -2
  25. package/dist/packages/core/src/components/PassCard/PassCardBgIHAB.js +6 -2
  26. package/dist/packages/core/src/components/PassCard/PassCardBgLeftColorGrid.js +3 -0
  27. package/dist/packages/core/src/components/PassCard/PassCardBgSoundLine.js +2 -2
  28. package/dist/packages/core/src/components/PassCard/PassCardBgSoundLineV1.js +3 -0
  29. package/dist/packages/core/src/components/PassCard/PassCardBgSoundMove.js +1 -1
  30. package/dist/packages/core/src/components/PassCard/PassCardBgSoundMoveV1.js +3 -0
  31. package/dist/packages/core/src/components/PassCard/PassCardBgTalk.js +1 -1
  32. package/dist/packages/core/src/components/PassCard/PassCardBgTalkV1.js +1 -1
  33. package/dist/packages/core/src/components/PassCard/PassCardBgTwoCircle.js +1 -1
  34. package/dist/packages/core/src/components/PaymentPlan.d.ts +15 -0
  35. package/dist/packages/core/src/components/PaymentPlan.js +4 -2
  36. package/dist/packages/core/src/components/Popup/DeviceSideTable.js +25 -1
  37. package/dist/packages/core/src/components/Popup/WordDataUpdatePopup.css +11 -3
  38. package/dist/packages/core/src/components/Report/ReportInfoPanel.css +12 -1
  39. package/dist/packages/core/src/components/SideNav.css +44 -0
  40. package/dist/packages/core/src/components/SoundCompass.js +18 -1
  41. package/dist/packages/core/src/components/Table.js +30 -1
  42. package/dist/packages/core/src/components/Tabs.js +1 -1
  43. package/dist/packages/core/src/components/TextField.js +25 -6
  44. package/dist/packages/core/src/components/Tooltip/WordImageTooltip.js +14 -5
  45. package/dist/packages/core/src/components/Training/CategoryIcon.js +8 -1
  46. package/dist/packages/core/src/components/Training/TrainingWordCard.js +15 -1
  47. package/dist/packages/core/src/components/UpdateAlert.css +11 -5
  48. package/dist/packages/core/src/components/Word/WordSearchResultBlock.css +5 -0
  49. package/dist/packages/core/src/components/Word/WordTableBlock.d.ts +1 -1
  50. package/dist/packages/core/src/components/Word/WordTableBlock.js +3 -3
  51. package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +6 -0
  52. package/dist/packages/core/src/components/WordTable.d.ts +18 -1
  53. package/dist/packages/core/src/components/WordTable.js +2 -2
  54. package/dist/packages/core/src/hooks/useWordAttributeFilter.d.ts +22 -1
  55. package/dist/packages/core/src/hooks/useWordAttributeFilter.js +53 -1
  56. package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -0
  57. package/dist/packages/core/src/hooks/useWordTrainingFilter.js +6 -2
  58. package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +3 -0
  59. package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +9 -3
  60. package/dist/packages/core/src/i18n/locales/en.json +7 -1
  61. package/dist/packages/core/src/i18n/locales/ko.json +6 -0
  62. package/dist/packages/core/src/styles.css +6 -1
  63. package/dist/packages/core/src/tokens.css +26 -8
  64. package/dist/packages/core/src/utils/lucideIconSet.js +6 -0
  65. package/dist/packages/core/src/utils/phonemePairSearch.d.ts +2 -0
  66. package/dist/packages/core/src/utils/phonemePairSearch.js +13 -4
  67. package/dist/packages/core/src/utils/phonemePairSearchTypes.d.ts +5 -6
  68. package/dist/packages/core/src/utils/wordAttributeFilterCodes.d.ts +69 -3
  69. package/dist/packages/core/src/utils/wordAttributeFilterCodes.js +162 -32
  70. package/dist/packages/core/src/version.d.ts +1 -1
  71. package/dist/packages/core/src/version.js +1 -1
  72. package/dist/utils.cjs.js +167 -162
  73. package/package.json +1 -1
@@ -14,22 +14,46 @@ export default function Dropdown({ options, value, onChange, placeholder, disabl
14
14
  const listId = useId();
15
15
  const valueId = useId();
16
16
  const containerRef = useRef(null);
17
+ /* **판을 창 안으로 조인다**(말귀 청 (369)).
18
+ 전에는 `left: rect.left` 만 적고 오른쪽을 안 봤다. 판은 `min-width: 트리거 폭` 이라
19
+ **항목 글이 길면 트리거보다 넓어지는데**, 트리거가 창 오른쪽 가에 있으면 그만큼
20
+ 화면 밖으로 나가 고를 수 없었다. 세로도 같다 — 아래가 모자라고 **위도 모자라면**
21
+ 늘 아래로 펴서 창 바닥 밖으로 나갔다.
22
+
23
+ `DatePicker` 가 이미 같은 셈을 쥐고 있다(그 파일의 `computeStyle`). 거기 적힌 두
24
+ 까닭을 그대로 따른다:
25
+ ① **판 높이는 열린 뒤에 잰다.** 어림값으로 위/아래를 정하면 어림이 작을 때 밖으로
26
+ 나가고 아무도 다시 안 잰다. 훅이 판이 선 뒤 다시 부른다.
27
+ ② **`top` 과 `bottom` 을 **둘 다** 적는다.** 안 쓰는 쪽을 비우면 스타일시트에 남은
28
+ 값이 자리를 가로채, 높이가 그 둘 사이로 눌린다. `auto` 로 지운다.
29
+
30
+ **덜 모자라는 쪽으로 편다** — 위도 아래도 모자라면 넓은 쪽이 낫다. */
17
31
  const computeStyle = useCallback((rect, trigger) => {
18
- // 아래쪽 공간이 메뉴 최대 높이(260px, Dropdown.css)보다 부족하고 위쪽에 공간이
19
- // 있으면 위로 뒤집는다 — DatePicker.tsx의 동일 패턴
32
+ const vh = window.innerHeight;
33
+ const vw = window.innerWidth;
34
+ /* 판의 실제 크기 — 열린 뒤에 재므로 있다. 없으면(첫 셈) 최대 높이로 어림한다.
35
+ `max-height: 260px`(Dropdown.css)에 눌리므로 그 수를 넘지 않는다. */
36
+ const panel = typeof document !== 'undefined' ? document.getElementById(listId) : null;
20
37
  const menuMaxH = 260;
21
- const spaceBelow = window.innerHeight - rect.bottom;
22
- const above = spaceBelow < menuMaxH && rect.top > menuMaxH;
38
+ const menuH = Math.min(menuMaxH, Math.max(panel?.offsetHeight || 0, panel?.scrollHeight || 0) || menuMaxH);
39
+ const menuW = Math.max(rect.width, panel?.offsetWidth || 0);
40
+ const spaceBelow = vh - rect.bottom;
41
+ const spaceAbove = rect.top;
42
+ const above = spaceBelow < menuH && spaceAbove > spaceBelow;
43
+ const margin = 8;
44
+ const clamp = (v, upper) => Math.min(Math.max(margin, v), Math.max(margin, upper));
23
45
  return {
24
46
  position: 'fixed',
25
- left: rect.left,
47
+ left: clamp(rect.left, vw - menuW - margin),
26
48
  minWidth: rect.width,
49
+ /* 판이 창보다 넓으면(아주 긴 항목 글) 창 안으로 눌린다 — 글은 `text-overflow` 가 받는다 */
50
+ maxWidth: Math.max(rect.width, vw - margin * 2),
27
51
  ...(above
28
- ? { bottom: window.innerHeight - rect.top + 6 }
29
- : { top: rect.bottom + 6 }),
52
+ ? { top: 'auto', bottom: clamp(vh - rect.top + 6, vh - menuH - margin) }
53
+ : { bottom: 'auto', top: clamp(rect.bottom + 6, vh - menuH - margin) }),
30
54
  zIndex: anchoredMenuZIndex(trigger),
31
55
  };
32
- }, []);
56
+ }, [listId]);
33
57
  const { open, setOpen, toggle: rawToggle, style: menuStyle, triggerRef, menuRef } = useAnchoredMenu({
34
58
  computeStyle,
35
59
  });
@@ -116,5 +116,5 @@ export default function FileUpload({ onFilesSelected, accept, multiple = false,
116
116
  return (_jsxs("div", { className: `file-upload ${className}`.trim(), children: [_jsxs("div", { className: cx('file-upload__dropzone', isDragging && 'file-upload__dropzone--dragging', disabled && 'file-upload__dropzone--disabled'), role: "button", tabIndex: disabled ? -1 : 0, "aria-disabled": disabled, onClick: handleBrowseClick, onKeyDown: e => { if (e.key === 'Enter' || e.key === ' ') {
117
117
  e.preventDefault();
118
118
  handleBrowseClick();
119
- } }, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, children: [_jsx(Icon, { icon: "upload", size: 24, className: "file-upload__icon" }), _jsx("span", { className: "file-upload__prompt body-2", children: t('fileUpload.dragPrompt', '파일을 이곳에 드래그하여 업로드') }), _jsx("button", { type: "button", className: "file-upload__browse-button body-3", disabled: disabled, onClick: e => { e.stopPropagation(); handleBrowseClick(); }, children: t('fileUpload.browseButton', '파일 선택') }), _jsx("input", { ref: inputRef, type: "file", className: "file-upload__input", accept: accept, multiple: multiple, disabled: disabled, onChange: handleInputChange, tabIndex: -1 })] }), showFileList && files.length > 0 && (_jsx("ul", { className: "file-upload__list", children: files.map((file, index) => (_jsxs("li", { className: "file-upload__list-item body-3", children: [_jsx("span", { className: "file-upload__file-name body-3", children: file.name }), _jsx("button", { type: "button", className: "file-upload__remove-button", "aria-label": t('fileUpload.removeAriaLabel', { name: file.name }), disabled: disabled, onClick: () => handleRemove(index), children: _jsx(Icon, { icon: "x", size: 14 }) })] }, `${file.name}-${index}`))) }))] }));
119
+ } }, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, children: [_jsx(Icon, { icon: "upload", size: 24, className: "file-upload__icon" }), _jsx("span", { className: "file-upload__prompt body-2", children: t('fileUpload.dragPrompt', '파일을 이곳에 드래그하여 업로드') }), _jsx("button", { type: "button", className: "file-upload__browse-button body-3", disabled: disabled, onClick: e => { e.stopPropagation(); handleBrowseClick(); }, children: t('fileUpload.browseButton', '파일 선택') }), _jsx("input", { ref: inputRef, type: "file", className: "file-upload__input", accept: accept, multiple: multiple, disabled: disabled, onChange: handleInputChange, tabIndex: -1, "aria-hidden": "true" })] }), showFileList && files.length > 0 && (_jsx("ul", { className: "file-upload__list", children: files.map((file, index) => (_jsxs("li", { className: "file-upload__list-item body-3", children: [_jsx("span", { className: "file-upload__file-name body-3", children: file.name }), _jsx("button", { type: "button", className: "file-upload__remove-button", "aria-label": t('fileUpload.removeAriaLabel', { name: file.name }), disabled: disabled, onClick: () => handleRemove(index), children: _jsx(Icon, { icon: "x", size: 14 }) })] }, `${file.name}-${index}`))) }))] }));
120
120
  }
@@ -1,5 +1,5 @@
1
1
  /*
2
- * **히어로 비주얼** — 랜딩 머리에 세우는 그림 열셋.
2
+ * **히어로 비주얼** — 랜딩 머리에 세우는 그림.
3
3
  *
4
4
  * 색은 **디자인 판(`Hero Visual Options`)의 팔레트 그대로**다. 짙은 파랑에서 라임까지
5
5
  * 여섯 칸이 한 줄기를 이룬다.
@@ -15,7 +15,7 @@
15
15
  * 이름이 빛깔이 아니라 **줄기의 몇 번째**인지를 말하는 것은 그대로 둔다. 덮어쓰는
16
16
  * 쪽이 제 색을 넣으면 `blue` 라는 이름이 바로 거짓이 되기 때문이다.
17
17
  *
18
- * 덮어쓰려면 `.hero-visual` 에 변수만 주면 된다 — 열셋이 한꺼번에 바뀐다.
18
+ * 덮어쓰려면 `.hero-visual` 에 변수만 주면 된다 — 꼴 전부가 한꺼번에 바뀐다.
19
19
  */
20
20
 
21
21
  .hero-visual {
@@ -39,8 +39,18 @@
39
39
  display: block;
40
40
  width: 100%;
41
41
  height: 100%;
42
+ /*
43
+ * **안 자른다**(사용자 지시 2026-11-09 — *"오버 플로우 비져블로"*).
44
+ *
45
+ * 상자를 그림에 바짝 맞춰 둔 탓에, 숨 쉬고 떠다니느라 잠깐 밖으로 나가는 만큼이
46
+ * 잘렸다 — 실측으로 다섯 꼴이 제 상자의 1.6~4% 를 넘는다(`stackedDiscs` 가 가장
47
+ * 커서 4%). 상자에 타를 두면 쉴 때 그림이 그만큼 작아지므로, **자르지 않는 쪽**을
48
+ * 골랐다. 쓰는 쪽에서 안으로 들여 받을 것이 없다.
49
+ */
50
+ overflow: visible;
42
51
  }
43
52
 
53
+
44
54
  /* 블롭에서 번져 나가는 고리 — 끊임없이 커졌다 사라지므로 미리 일러둔다 */
45
55
  .hero-visual__ring {
46
56
  will-change: transform, opacity;
@@ -64,6 +74,23 @@
64
74
  animation-delay: calc(var(--hero-visual-cycle) * var(--hero-visual-turn, 0));
65
75
  }
66
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
+
67
94
  .hero-visual__in--bloom { animation-name: hero-visual-bloom; }
68
95
  .hero-visual__in--draw { animation-name: hero-visual-draw; }
69
96
  .hero-visual__in--fade { animation-name: hero-visual-fade; }
@@ -79,7 +106,7 @@
79
106
  * **하나를 돌려 쓰지 않는다**(사용자 지시 2026-11-09 — *"그냥 스르륵 나오는건 재미없잖아
80
107
  * 공통으로 사용하지말고"*). 꼴마다 제 몸에 맞는 길로 들고 난다 —
81
108
  *
82
- * · 선은 **제 손으로 그어졌다 지워지고**(`draw`)
109
+ * · 선·테·막대는 **제 손으로 그어졌다 지워지고**(`draw`)
83
110
  * · 꽃잎·점·원판은 **톡 튀어나오고**(`pop`)
84
111
  * · 필은 **하나였다가 셋으로 갈라지고**(`fan`)
85
112
  * · 구체는 **제자리에서 오므라졌다 번지고**(`settle`)
@@ -110,12 +137,22 @@
110
137
  100% { opacity: 0; transform: scale(.2); }
111
138
  }
112
139
 
113
- /* 선이 제 손으로 그어졌다 **그어 온 길을 되짚어** 걷힌다. `pathLength="1"` 이라
114
- 길이가 달라도 같은 박자로 간다 */
140
+ /*
141
+ * 선이 제 손으로 그어졌다 **그어 온 길을 되짚어** 걷힌다. `pathLength="1"` 이라 길이가
142
+ * 달라도 같은 박자로 간다.
143
+ *
144
+ * **짙기도 함께 꺼야 한다**(사용자 지시 2026-11-09 — *"처음시작 점과 마지막 점도 완전히
145
+ * 사라지도록"*). 끝을 둥글린 선은 길이를 0 으로 줄여도 **둥근 끝 두 개가 점으로 남는다**
146
+ * — 길이는 줄어도 마개는 그 자리에 찍히기 때문이다.
147
+ *
148
+ * 그래서 짙기를 쓰는 도형은 **제 짙기를 바깥 묶음에 둔다** — 여기서 `opacity` 를 쥐므로
149
+ * 도형에 직접 적으면 덮인다.
150
+ */
115
151
  @keyframes hero-visual-draw {
116
- 0% { stroke-dashoffset: 1; }
117
- 26%, 76% { stroke-dashoffset: 0; }
118
- 100% { stroke-dashoffset: 1; }
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; }
119
156
  }
120
157
 
121
158
  @keyframes hero-visual-fade {
@@ -150,12 +187,16 @@
150
187
  *
151
188
  * 전에는 좌우로 펴지게 했는데(`scaleX`), 납작한 막대가 가로로만 늘면 **Y 축을 도는
152
189
  * 것처럼** 보여 2D 가 깨졌다(사용자 지시 — *"y 축 로테이션 별로야 2d 공간을 유지"*).
190
+ *
191
+ * **포개진 모습은 안 보인다.** 한때 포개진 채로 또렷해졌다가(9%) 펴지고, 다시 포개진
192
+ * 채로 머물다 꺼졌는데(93%), 그 동안 세 장이 겹친 것이 그대로 드러나 거슬렸다(사용자
193
+ * 지시 2026-11-09 — *"나오는 초반이나 사라지는 마지막에 겹쳐있는게 좀 많이 보여서
194
+ * 거슬려 펴지면서 나오고 겹치면서 사라지도록"*). 지금은 **펴지면서 밝아지고 겹치면서
195
+ * 꺼진다** — 포개진 자리는 투명한 자리와 겹친다.
153
196
  */
154
197
  @keyframes hero-visual-fan {
155
198
  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
199
  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
200
  100% { opacity: 0; transform: translateY(var(--dy, 0)) rotate(0deg) scale(.96); }
160
201
  }
161
202
 
@@ -167,6 +208,7 @@
167
208
  * 여정이 상자 밖이라 **들어오는 동안 반달로 잘렸다**(`s4 베시카` 실측). 상자를 넓히면
168
209
  * 쉴 때 빈 자리가 생기므로, 여정을 안쪽으로 접었다.
169
210
  */
211
+
170
212
  @keyframes hero-visual-meet {
171
213
  0% { opacity: 0; transform: translateX(var(--from, -200px)); }
172
214
  18%, 76% { opacity: 1; transform: translateX(0); }
@@ -253,6 +295,47 @@
253
295
  0%, 100% { transform: translateX(0); }
254
296
  50% { transform: translateX(14px); }
255
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
+
256
339
  @keyframes hero-visual-sway {
257
340
  0%, 100% { transform: rotate(-6deg); }
258
341
  50% { transform: rotate(6deg); }
@@ -29,18 +29,38 @@ export type HeroVisualVariant =
29
29
  /** 납작한 반투명 원판이 위에서 아래로 쌓인다 */
30
30
  | 'stackedDiscs'
31
31
  /** 중심을 둘러싼 원 여섯이 숨 네 번마다 한 번 가운데로 모였다 펴진다 */
32
- | 'flower';
32
+ | 'flower'
33
+ /** 모난 데를 둥글린 네모 셋이 포개져 저마다 숨 쉰다 */
34
+ | 'squircles'
35
+ /** 점 아홉이 격자로 서서 하나씩 깜빡인다 */
36
+ | 'dotGrid'
37
+ /** 막대 넷이 층계처럼 키를 달리해 오르내린다 */
38
+ | 'stairs';
33
39
  /** @public */
34
40
  export interface HeroVisualProps {
35
41
  /** 어떤 그림인가 */
36
42
  variant: HeroVisualVariant;
37
43
  /**
38
44
  * `'loop'`(기본) — 등장 · 머묾 · 퇴장을 되풀이한다.
45
+ *
46
+ * `'once'` — **한 바퀴만 돌고 다 나간 채로 선다.** 꼴을 차례로 갈아 끼울 때 쓴다 —
47
+ * 되풀이되는 동안에는 조각마다 차례가 달라 **모두가 함께 비는 때가 없어**, 갈아
48
+ * 끼우면 사라지는 중인 조각이 잘린다. 다 나간 때는 `onCycleEnd` 가 알려 준다.
49
+ *
39
50
  * `'still'` — **멈춰 선 한 장**. 한 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다.
40
51
  *
41
- * 움직임을 줄여 달라고 한 기기에서는 `'loop'` 라도 `'still'` 처럼 선다.
52
+ * 움직임을 줄여 달라고 한 기기에서는 `'loop'`·`'once'` 라도 `'still'` 처럼 선다.
53
+ */
54
+ motion?: 'loop' | 'once' | 'still';
55
+ /**
56
+ * `motion="once"` 에서 **가장 늦은 조각까지 다 나간 뒤** 한 번 불린다.
57
+ *
58
+ * 다른 `motion` 에서는 안 불린다 — 되풀이되는 동안에는 "다 나갔다" 는 때가 없다.
59
+ *
60
+ * 움직임이 멎은 자리(움직임 줄이기 · 숨은 탭)에서도 **반드시 한 번은 불린다** —
61
+ * 안 그러면 이것으로 다음 꼴을 세우는 쪽이 첫 꼴에서 멈춘 채 조용해진다.
42
62
  */
43
- motion?: 'loop' | 'still';
63
+ onCycleEnd?: () => void;
44
64
  /** 한 바퀴에 걸리는 시간(ms). 기본 9000 */
45
65
  cycleMs?: number;
46
66
  /**
@@ -56,10 +76,13 @@ export declare const HERO_VISUAL_VARIANTS: HeroVisualVariant[];
56
76
  /**
57
77
  * **히어로 비주얼** — 랜딩 머리에 세우는 그림.
58
78
  *
59
- * 디자인 판(claude.ai/design 의 `Hero Visual Options`)에서 고른 꼴 열셋을 한 컴포넌트가
60
- * 쥔다. `variant` 하나만 바꾸면 그림이 바뀐다.
79
+ * 디자인 판(claude.ai/design 의 `Hero Visual Options` · `말귀 심볼 확장`)에서 고른 꼴을
80
+ * 한 컴포넌트가 쥔다. `variant` 하나만 바꾸면 그림이 바뀐다.
61
81
  *
62
- * **한 바퀴는 등장 · 머묾 · 퇴장이다.** 머무는 동안이 한 바퀴의 6할이라, 그림이 제 꼴로
82
+ * **한 바퀴는 등장 · 머묾 · 퇴장이다.** 차례로 갈아 끼우려면 `motion="once"` 로 두고
83
+ * `onCycleEnd` 를 받는다 — 되풀이되는 동안에는 조각마다 차례가 달라 **모두가 함께
84
+ * 비는 때가 없어서**, 아무 때나 갈아 끼우면 사라지는 중인 조각이 잘린다.
85
+ * 머무는 동안이 한 바퀴의 6할이라, 그림이 제 꼴로
63
86
  * 서 있는 시간이 가장 길다. `motion="still"` 이면 **멈춰 선 한 장**이 되는데, 이때는 한
64
87
  * 바퀴뿐 아니라 그림 안쪽의 숨·떨림까지 멈춘다 — 바깥만 멈추면 "멈춘 그림" 이 아니라
65
88
  * "제자리에서 꿈틀대는 그림" 이 된다.
@@ -76,4 +99,4 @@ export declare const HERO_VISUAL_VARIANTS: HeroVisualVariant[];
76
99
  *
77
100
  * @public
78
101
  */
79
- export default function HeroVisual({ variant, motion, cycleMs, label, className, style, }: HeroVisualProps): import("react").JSX.Element;
102
+ export default function HeroVisual({ variant, motion, cycleMs, label, className, style, onCycleEnd, }: HeroVisualProps): import("react").JSX.Element;