@ihabdevteam/core 0.388.0 → 0.390.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 +96 -0
  2. package/dist/components.cjs.js +174 -174
  3. package/dist/components.esm.css +1 -1
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core.cjs.js +40 -40
  7. package/dist/ihabdevteam-core.d.ts +87 -42
  8. package/dist/packages/core/src/components/Badge.css +27 -0
  9. package/dist/packages/core/src/components/Badge.d.ts +29 -31
  10. package/dist/packages/core/src/components/Badge.js +25 -49
  11. package/dist/packages/core/src/components/BottomNav.js +3 -3
  12. package/dist/packages/core/src/components/CircleBadge.d.ts +45 -11
  13. package/dist/packages/core/src/components/CircleBadge.js +58 -7
  14. package/dist/packages/core/src/components/Header.js +2 -2
  15. package/dist/packages/core/src/components/SideNav.js +3 -3
  16. package/dist/packages/core/src/components/Tooltip/MenuTooltip.js +2 -2
  17. package/dist/packages/core/src/components/Training/TrainingBlockButton.js +2 -2
  18. package/dist/packages/core/src/components/Training/TrainingWordCard.js +2 -2
  19. package/dist/packages/core/src/hooks/useWordAttributeFilter.js +27 -4
  20. package/dist/packages/core/src/i18n/locales/en.json +6 -1
  21. package/dist/packages/core/src/i18n/locales/ko.json +6 -1
  22. package/dist/packages/core/src/utils/phonemePairSearch.d.ts +2 -0
  23. package/dist/packages/core/src/utils/phonemePairSearch.js +1 -1
  24. package/dist/packages/core/src/utils/phonemePairSearchTypes.d.ts +12 -0
  25. package/dist/packages/core/src/utils/wordAttributeFilterCodes.d.ts +11 -1
  26. package/dist/packages/core/src/utils/wordAttributeFilterCodes.js +50 -8
  27. package/dist/packages/core/src/utils/wordTrainingPool.d.ts +3 -1
  28. package/dist/packages/core/src/utils/wordTrainingPool.js +2 -2
  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 +3 -3
  32. package/package.json +1 -1
@@ -226,18 +226,15 @@ export declare type BadgeFill = 'filled' | 'outline' | 'soft';
226
226
  /** @public */
227
227
  export declare interface BadgeProps {
228
228
  /**
229
- * 뱃지 스타일 구분
230
- * - `bar` — 텍스트 레이블 뱃지 (기본값)
231
- * - `dot` — 원형 아이콘/숫자 뱃지 (부모 기준 absolute 배치)
232
- */
233
- type?: BadgeType;
234
- /**
235
- * 크기.
236
- * - dot(CircleBadge) — Button과 같은 숫자 스케일 `24 | 32 | 40`. 기본값 32.
237
- * - bar — `'small' | 'medium' | 'large'`. 기본값 'medium'.
229
+ * 뱃지 꼴
230
+ * - `dot` — 작은 알약 이름표 (**기본값**)
231
+ * - `bar` — 넓게 눕는 띠 (줄 하나를 통째로 쓴다)
238
232
  *
239
- * (dot에 문자열을, bar에 숫자를 넘기면 각자의 기본값으로 렌더된다.)
233
+ * 원형 아이콘·숫자는 이 컴포넌트가 아니라 **`CircleBadge`** 가 그린다.
240
234
  */
235
+ type?: BadgeType;
236
+ /** 크기 — `'small' | 'medium' | 'large'`(기본값 `'medium'`). 두 꼴이 같은 자를 쓴다.
237
+ * 숫자를 넘기면(옛 `dot` 의 `24 | 32 | 40`) 기본값으로 떨어뜨린다. */
241
238
  size?: 'small' | 'medium' | 'large' | BadgeDotSize;
242
239
  className?: string;
243
240
  /**
@@ -275,34 +272,35 @@ export declare interface BadgeProps {
275
272
  iconLeft?: ReactNode | string;
276
273
  /** 우측 아이콘 (bar 전용). Lucide 아이콘 이름 또는 ReactNode */
277
274
  iconRight?: ReactNode | string;
278
- /**
279
- * 아이콘 종류 (dot 전용). `number` 가 없고 이것도 없으면 `check` 로 그린다.
280
- * - `check` — 선택/완료 (파란 체크)
281
- * - `remove` — 제거 (빨간 ×)
282
- * - `minus` — 비활성/제외 (회색 —)
283
- */
275
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
284
276
  icon?: BadgeDotIcon;
285
- /** 표시할 숫자 (dot 전용, icon 대신 숫자 표시) */
277
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
286
278
  number?: number;
287
- /**
288
- * 배치 위치 (dot 전용). 기본값 'top-right'
289
- * - `top-right` / `top-left` — 부모 모서리에 absolute 오버레이
290
- * - `inline` — 흐름 안에 배치(불릿·단계 번호 등). position: static
291
- */
279
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
292
280
  position?: 'top-right' | 'top-left' | 'inline';
293
- /** 클릭 핸들러 (dot 전용) — 설정 시 pointer-events 활성화 */
281
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다(누를 수 있는 뱃지도 그쪽이다). */
294
282
  onClick?: (e: MouseEvent_2) => void;
295
- /**
296
- * 등장 애니메이션 (dot 전용). 기본값 false.
297
- * 선택·완료처럼 뱃지가 '그 순간' 나타나는 자리에서 켜면 톡 튀어나오는 효과가 붙는다.
298
- * 목록처럼 처음부터 떠 있는 뱃지에는 끄는 편이 낫다(로드 때마다 다 같이 튄다).
299
- * 모션 최소화 설정(prefers-reduced-motion)에서는 자동으로 비활성화된다.
300
- */
283
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
301
284
  animate?: boolean;
302
285
  }
303
286
 
304
- /** @public */
305
- export declare type BadgeType = 'bar' | 'dot';
287
+ /**
288
+ * `Badge` 의 두 꼴 — **2026-10-28 에 이름이 한 칸씩 옮겨 앉았다**(사용자 지시).
289
+ *
290
+ * - `dot` — **작은 알약 이름표**(기본값). 전에 `bar` 가 그리던 그림이다.
291
+ * - `bar` — **넓게 눕는 띠**(새로). 줄 하나를 통째로 쓴다.
292
+ *
293
+ * 전에 `dot` 은 **원형 아이콘·숫자**였는데, 그 그림은 `CircleBadge` 가 따로 들고 나가
294
+ * 두 자리에서 같은 것을 그리고 있었다. 그래서 이 컴포넌트에서는 뺐다 — 원형이 필요하면
295
+ * **`CircleBadge` 를 쓴다.**
296
+ *
297
+ * **글자는 같고 뜻만 바뀌었다 — `tsc` 가 한마디도 안 한다.** 고친 자리와 안 고친 자리가
298
+ * 둘 다 타입이 멀쩡하다. 그래서 옛 `dot` 에만 있던 프롭(`icon`·`number`·`position`·
299
+ * `animate`)이 들어오면 개발 모드에서 말한다(아래 `Badge` 머리말).
300
+ *
301
+ * @public
302
+ */
303
+ export declare type BadgeType = 'dot' | 'bar';
306
304
 
307
305
  /** 장수와 한 줄 최대로 칸 수 — 한 줄에 다 들면 그대로, 접히면 고르게 */
308
306
  export declare function balancedColumns(count: number, perRow: number): number;
@@ -1372,36 +1370,71 @@ export declare function ChoiceChips({ subs, selected, onSelect, size }: {
1372
1370
  export declare const CHOSEONG: readonly ["ㄱ", "ㄲ", "ㄴ", "ㄷ", "ㄸ", "ㄹ", "ㅁ", "ㅂ", "ㅃ", "ㅅ", "ㅆ", "ㅇ", "ㅈ", "ㅉ", "ㅊ", "ㅋ", "ㅌ", "ㅍ", "ㅎ"];
1373
1371
 
1374
1372
  /**
1375
- * 원형 식별 배지 — 짧은 문자/숫자를 원 안에 보여준다.
1373
+ * **원형 뱃지** — 숫자·체크·×·짧은 글자를 원 안에 보여 준다.
1376
1374
  *
1377
- * `Badge type="dot"` 은 숫자(number)나 아이콘(check/remove/minus)만 그리므로,
1378
- * R/L 처럼 임의 문자를 원에 담아야 할 때 이 컴포넌트를 쓴다. 스타일은 Badge 의
1379
- * `.circle-badge` 를 그대로 재사용한다(파란 원 + 흰 글자).
1375
+ * **2026-10-28 에 이 컴포넌트가 원형을 통째로 받았다**(사용자 지시). 전에는 같은 그림을
1376
+ * `Badge type="dot"` 도 그려, **두 자리가 같은 것을 그리고** 있었다. 이제 원형은 여기 하나다 —
1377
+ * `Badge` 의 `dot` 은 **작은 알약 이름표**를 뜻한다.
1380
1378
  *
1381
1379
  * @example
1382
1380
  * <div style={{ position: 'relative' }}>
1383
1381
  * <input />
1384
1382
  * <CircleBadge>R</CircleBadge>
1383
+ * <CircleBadge number={3} size={24} aria-hidden />
1384
+ * <CircleBadge icon="remove" onClick={remove} />
1385
1385
  * </div>
1386
1386
  * @public
1387
1387
  */
1388
- export declare function CircleBadge({ children, position, size, className, }: CircleBadgeProps): JSX.Element;
1388
+ export declare function CircleBadge({ children, icon, number, position, size, animate, onClick, 'aria-label': ariaLabel, 'aria-hidden': ariaHidden, className, }: CircleBadgeProps): JSX.Element;
1389
+
1390
+ /** 원 안에 그릴 아이콘. @public */
1391
+ declare type CircleBadgeIcon = 'check' | 'remove' | 'minus';
1389
1392
 
1390
1393
  /** 부모 코너 배치. inline 은 흐름 배치. @public */
1391
1394
  export declare type CircleBadgePosition = 'top-left' | 'top-right' | 'inline';
1392
1395
 
1393
1396
  /** @public */
1394
1397
  export declare interface CircleBadgeProps {
1395
- /** 원 안에 표시할 내용(R/L·숫자·짧은 문자). */
1396
- children: ReactNode;
1397
- /** 부모(position:relative) 코너 배치. 기본 좌상단. inline 이면 흐름 배치. */
1398
+ /**
1399
+ * 원 안에 그릴 것 — `R`·`L` 처럼 짧은 글자. 안 주면 `number` 를, 그것도 없으면
1400
+ * `icon`(기본 `check`)을 그린다.
1401
+ */
1402
+ children?: ReactNode;
1403
+ /**
1404
+ * 아이콘 종류. `children` 도 `number` 도 없으면 이것으로 그리고, 이것도 없으면 `check` 다.
1405
+ * - `check` — 선택·완료(파란 체크)
1406
+ * - `remove` — 제거(빨간 ×)
1407
+ * - `minus` — 제외(회색 —)
1408
+ */
1409
+ icon?: CircleBadgeIcon;
1410
+ /** 숫자를 그린다 — `icon` 대신이다. */
1411
+ number?: number;
1412
+ /** 부모(`position: relative`) 모서리 배치. 기본 좌상단. `inline` 이면 흐름 배치. */
1398
1413
  position?: CircleBadgePosition;
1399
- /** 크기 스케일. 기본 24. */
1414
+ /** 크기 자. 기본 24. */
1400
1415
  size?: CircleBadgeSize;
1416
+ /**
1417
+ * 등장 애니메이션. 기본 꺼짐.
1418
+ * 선택·완료처럼 **그 순간** 나타나는 자리에서 켠다. 목록처럼 처음부터 떠 있는 자리에는
1419
+ * 끄는 편이 낫다(열 때마다 다 같이 튄다). 모션 최소화 설정에서는 저절로 꺼진다.
1420
+ */
1421
+ animate?: boolean;
1422
+ /** 누를 수 있게 한다 — 주면 진짜 단추처럼 자판으로도 눌린다. */
1423
+ onClick?: (e: MouseEvent_2) => void;
1424
+ /**
1425
+ * 낭독기가 읽을 이름. 안 주면 그림에 따라 '선택됨'·'제거'·'제외'·'N번째 선택' 으로 짓는다.
1426
+ */
1427
+ 'aria-label'?: string;
1428
+ /**
1429
+ * 낭독기에서 숨긴다. 개수를 곁의 단추 이름에 이미 넣었을 때 쓴다 —
1430
+ * 예: `SideNav`·`BottomNav` 는 단추 이름을 "숙제, 3개" 로 짓고 이 뱃지는 숨긴다.
1431
+ * 주면 `aria-label` 보다 이긴다.
1432
+ */
1433
+ 'aria-hidden'?: boolean;
1401
1434
  className?: string;
1402
1435
  }
1403
1436
 
1404
- /** 크기 스케일 — Button/Badge dot 과 동일. @public */
1437
+ /** 크기 스케일 — Button 과 같은 숫자 자. @public */
1405
1438
  export declare type CircleBadgeSize = 24 | 32 | 40;
1406
1439
 
1407
1440
  /** @public @deprecated Use BadgeDotIcon */
@@ -1787,7 +1820,7 @@ export declare function copyText(text: string): Promise<boolean>;
1787
1820
  *
1788
1821
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
1789
1822
  */
1790
- export declare const CORE_VERSION = "0.388.0";
1823
+ export declare const CORE_VERSION = "0.390.0";
1791
1824
 
1792
1825
  /** @public */
1793
1826
  declare const coreDefault: Record<string, unknown>;
@@ -11230,6 +11263,18 @@ export declare interface WordEntry {
11230
11263
  pronunciation: string;
11231
11264
  colloquialPronunciation?: string;
11232
11265
  grade?: string;
11266
+ /**
11267
+ * **나이** — `grade` 가 `'1'` 인 낱말을 더 잘게 가른다(말귀 청 (342), 2026-10-28).
11268
+ *
11269
+ * 1등급 5,000개가 한 칸에 몰려 있어 치료사가 또래를 고를 수 없었다. 그래서 `grade` 는
11270
+ * **그대로 두고**(저장된 표 열셋이 그 코드를 쥐고 있다) 그 안을 이 칸으로 가른다 —
11271
+ * 거르개의 `age3`~`age7` 이 `grade === '1' && age === n` 을 뜻한다.
11272
+ *
11273
+ * 2~4등급에는 이 값이 없다. 그 셋은 등급 그대로 고른다.
11274
+ */
11275
+ age?: number;
11276
+ /** **활용도가 높은 낱말인가** — 거르개의 '활용도 높은 단어만' 이 이것을 본다(청 (342)). */
11277
+ usage?: boolean;
11233
11278
  pos?: string;
11234
11279
  wordType?: string;
11235
11280
  field?: string;
@@ -88,3 +88,30 @@
88
88
 
89
89
 
90
90
 
91
+
92
+ /* ── `bar` — 넓게 눕는 띠(사용자 지시 2026-10-28) ────────────────────────────
93
+
94
+ `dot`(작은 알약)과 **색은 똑같다** — 위의 `--badge-color` 한 변수를 그대로 쓰므로
95
+ `variant` · `fill` · `color` 조합이 둘에서 같이 산다. 다른 것은 **눕는 꼴**뿐이다:
96
+ 줄 하나를 통째로 쓰고, 글자는 왼쪽에 붙고, 모서리가 알약이 아니라 상자다.
97
+
98
+ **`Alert` 와 그림이 비슷하지만 하는 일이 다르다.** `Alert` 는 **말을 한다** —
99
+ `role="alert"`/`role="status"` 로 낭독기에 끼어든다. 이 띠는 **보여 줄 뿐**이라
100
+ 끼어들지 않는다. 반드시 읽혀야 하는 줄(로그인 오류 따위)은 `Alert` 가 맞다.
101
+ 그림으로 고르지 말고 **"말을 해야 하나"로** 고른다. */
102
+ .badge--bar {
103
+ display: flex;
104
+ width: 100%;
105
+ justify-content: flex-start;
106
+ text-align: left;
107
+ /* 알약의 `999px` 이 아니라 상자 모서리 — 눕는 띠는 끝이 둥글면 알약이 늘어난 것처럼 보인다 */
108
+ border-radius: var(--radius-sm);
109
+ /* 글자가 길면 줄을 바꾼다 — 알약은 `nowrap` 이지만 띠는 한 줄을 다 쓰므로 가둘 까닭이 없다 */
110
+ white-space: normal;
111
+ line-height: 1.45;
112
+ }
113
+
114
+ /* 눕는 띠의 안쪽 여백 — 알약의 `height` 자리를 쓴다(띠는 글자 수대로 높이가 는다) */
115
+ .badge--bar.badge--small { padding: var(--spacing-xs) var(--spacing-s); height: auto; }
116
+ .badge--bar.badge--medium { padding: var(--spacing-s) var(--spacing-m); height: auto; }
117
+ .badge--bar.badge--large { padding: var(--spacing-m) var(--spacing-m); height: auto; }
@@ -1,8 +1,23 @@
1
1
  import { type ReactNode, type MouseEvent } from 'react';
2
2
  import './Badge.css';
3
3
  import './CircleBadge.css';
4
- /** @public */
5
- export type BadgeType = 'bar' | 'dot';
4
+ /**
5
+ * `Badge` 의 두 꼴 — **2026-10-28 에 이름이 한 칸씩 옮겨 앉았다**(사용자 지시).
6
+ *
7
+ * - `dot` — **작은 알약 이름표**(기본값). 전에 `bar` 가 그리던 그림이다.
8
+ * - `bar` — **넓게 눕는 띠**(새로). 줄 하나를 통째로 쓴다.
9
+ *
10
+ * 전에 `dot` 은 **원형 아이콘·숫자**였는데, 그 그림은 `CircleBadge` 가 따로 들고 나가
11
+ * 두 자리에서 같은 것을 그리고 있었다. 그래서 이 컴포넌트에서는 뺐다 — 원형이 필요하면
12
+ * **`CircleBadge` 를 쓴다.**
13
+ *
14
+ * **글자는 같고 뜻만 바뀌었다 — `tsc` 가 한마디도 안 한다.** 고친 자리와 안 고친 자리가
15
+ * 둘 다 타입이 멀쩡하다. 그래서 옛 `dot` 에만 있던 프롭(`icon`·`number`·`position`·
16
+ * `animate`)이 들어오면 개발 모드에서 말한다(아래 `Badge` 머리말).
17
+ *
18
+ * @public
19
+ */
20
+ export type BadgeType = 'dot' | 'bar';
6
21
  /** @public */
7
22
  export type BadgeFill = 'filled' | 'outline' | 'soft';
8
23
  /** @public */
@@ -14,18 +29,15 @@ export type BadgeDotSize = 24 | 32 | 40;
14
29
  /** @public */
15
30
  export interface BadgeProps {
16
31
  /**
17
- * 뱃지 스타일 구분
18
- * - `bar` — 텍스트 레이블 뱃지 (기본값)
19
- * - `dot` — 원형 아이콘/숫자 뱃지 (부모 기준 absolute 배치)
20
- */
21
- type?: BadgeType;
22
- /**
23
- * 크기.
24
- * - dot(CircleBadge) — Button과 같은 숫자 스케일 `24 | 32 | 40`. 기본값 32.
25
- * - bar — `'small' | 'medium' | 'large'`. 기본값 'medium'.
32
+ * 뱃지 꼴
33
+ * - `dot` — 작은 알약 이름표 (**기본값**)
34
+ * - `bar` — 넓게 눕는 띠 (줄 하나를 통째로 쓴다)
26
35
  *
27
- * (dot에 문자열을, bar에 숫자를 넘기면 각자의 기본값으로 렌더된다.)
36
+ * 원형 아이콘·숫자는 이 컴포넌트가 아니라 **`CircleBadge`** 가 그린다.
28
37
  */
38
+ type?: BadgeType;
39
+ /** 크기 — `'small' | 'medium' | 'large'`(기본값 `'medium'`). 두 꼴이 같은 자를 쓴다.
40
+ * 숫자를 넘기면(옛 `dot` 의 `24 | 32 | 40`) 기본값으로 떨어뜨린다. */
29
41
  size?: 'small' | 'medium' | 'large' | BadgeDotSize;
30
42
  className?: string;
31
43
  /**
@@ -63,29 +75,15 @@ export interface BadgeProps {
63
75
  iconLeft?: ReactNode | string;
64
76
  /** 우측 아이콘 (bar 전용). Lucide 아이콘 이름 또는 ReactNode */
65
77
  iconRight?: ReactNode | string;
66
- /**
67
- * 아이콘 종류 (dot 전용). `number` 가 없고 이것도 없으면 `check` 로 그린다.
68
- * - `check` — 선택/완료 (파란 체크)
69
- * - `remove` — 제거 (빨간 ×)
70
- * - `minus` — 비활성/제외 (회색 —)
71
- */
78
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
72
79
  icon?: BadgeDotIcon;
73
- /** 표시할 숫자 (dot 전용, icon 대신 숫자 표시) */
80
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
74
81
  number?: number;
75
- /**
76
- * 배치 위치 (dot 전용). 기본값 'top-right'
77
- * - `top-right` / `top-left` — 부모 모서리에 absolute 오버레이
78
- * - `inline` — 흐름 안에 배치(불릿·단계 번호 등). position: static
79
- */
82
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
80
83
  position?: 'top-right' | 'top-left' | 'inline';
81
- /** 클릭 핸들러 (dot 전용) — 설정 시 pointer-events 활성화 */
84
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다(누를 수 있는 뱃지도 그쪽이다). */
82
85
  onClick?: (e: MouseEvent) => void;
83
- /**
84
- * 등장 애니메이션 (dot 전용). 기본값 false.
85
- * 선택·완료처럼 뱃지가 '그 순간' 나타나는 자리에서 켜면 톡 튀어나오는 효과가 붙는다.
86
- * 목록처럼 처음부터 떠 있는 뱃지에는 끄는 편이 낫다(로드 때마다 다 같이 튄다).
87
- * 모션 최소화 설정(prefers-reduced-motion)에서는 자동으로 비활성화된다.
88
- */
86
+ /** @deprecated 원형 뱃지는 `CircleBadge` 가 그린다. */
89
87
  animate?: boolean;
90
88
  }
91
89
  /** @public */
@@ -1,70 +1,46 @@
1
1
  'use client';
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { cx } from '../utils/cx';
4
- import { useTranslation } from 'react-i18next';
5
4
  import Icon from './Icon';
5
+ import { devWarnOnce } from '../utils/devWarn';
6
6
  import './Badge.css';
7
7
  /* 점 가지(`type="dot"`)가 **`CircleBadge` 와 같은 꼴**을 그린다 — 그 규칙은 그쪽 파일에
8
8
  산다(`NAMING.md` §3). 이 컴포넌트를 통째로 쓰는 화면이 `CircleBadge` 를 안 그릴 수 있어
9
9
  여기서 직접 들여온다. */
10
10
  import './CircleBadge.css';
11
- // ── 내부 아이콘 ────────────────────────────────────────────────────────────
12
- function CheckIcon() {
13
- return (_jsx("svg", { viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.2, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("polyline", { points: "2,6 5,9 10,3" }) }));
14
- }
15
- function RemoveIcon() {
16
- return (_jsxs("svg", { viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.2, strokeLinecap: "round", "aria-hidden": "true", children: [_jsx("line", { x1: "3", y1: "3", x2: "9", y2: "9" }), _jsx("line", { x1: "9", y1: "3", x2: "3", y2: "9" })] }));
17
- }
18
- function MinusIcon() {
19
- return (_jsx("svg", { viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.2, strokeLinecap: "round", "aria-hidden": "true", children: _jsx("line", { x1: "2.5", y1: "6", x2: "9.5", y2: "6" }) }));
20
- }
11
+ /* 체크·×·— 아이콘은 `CircleBadge` 가 제 것을 들고 있다 — 원형을 떼면서 여기서는 지웠다
12
+ (2026-10-28). 두 자리에 같은 그림이 있던 것이 이번에 푼 매듭이다. */
21
13
  // ── 컴포넌트 ───────────────────────────────────────────────────────────────
22
14
  /** @public */
23
15
  export default function Badge(props) {
24
- const { t } = useTranslation();
25
- const { type = 'bar', size, className = '', 'aria-label': ariaLabel, 'aria-hidden': ariaHidden, } = props;
26
- // ── dot (원형) ──────────────────────────────────────────────────────────
27
- if (type === 'dot') {
28
- const { icon, number, position = 'top-right', onClick, animate = false } = props;
29
- // icon 을 안 주면 check 다 — 클래스(파란 바탕)·기본 이름('선택됨')이 이미 check 로 가는데
30
- // 그리는 쪽만 `icon === 'check'` 을 봐서 **체크 없는 파란 원**이 나왔다. 셋이 같은 값을 보게 한다.
31
- const dotIcon = icon ?? 'check';
32
- const dotVariant = number !== undefined ? 'number' : dotIcon;
33
- // dot 크기는 Button과 같은 숫자 스케일 — 문자열이 오면 기본값(32)으로 떨어뜨린다.
34
- const dotSize = typeof size === 'number' ? size : 32;
35
- const cls = cx('circle-badge', `circle-badge--${dotVariant}`, `circle-badge--${position}`, `circle-badge--${dotSize}`, animate ? 'circle-badge--animate' : '', onClick ? 'circle-badge--clickable' : '', className);
36
- // 기본 이름을 한국어로 박아 두면 영문 화면에서도 낭독기만 한국어로 읽었다 — 사전을 거친다.
37
- const defaultLabel = number !== undefined
38
- ? t('badge.nthSelected', { n: number, defaultValue: '{{n}}번째 선택' })
39
- : {
40
- check: t('badge.selected', '선택됨'),
41
- remove: t('badge.remove', '제거'),
42
- minus: t('badge.exclude', '제외'),
43
- }[dotIcon];
44
- return (_jsxs("span", { className: cls, onClick: onClick,
45
- /* `<span role="button">` 은 브라우저가 Enter·Space 를 눌림으로 바꿔 주지 않는다.
46
- tabIndex 만 있으면 키보드 사용자는 **그 자리에 멈추고도 아무것도 못 한다** —
47
- 닿기만 하고 눌리지 않는 편이 아예 못 닿는 것보다 나쁘다(2026-08-28).
48
- Space 의 기본 동작(페이지 스크롤)도 막는다(Accordion 과 같은 처리). */
49
- onKeyDown: onClick ? (e) => {
50
- if (e.key !== 'Enter' && e.key !== ' ')
51
- return;
52
- /* onClick 이 MouseEvent 를 받으므로 가짜로 만들지 않고 **DOM 이 진짜 클릭을
53
- 내게** 한다 — 그래야 이벤트의 target·currentTarget 도 실제와 같다. */
54
- e.preventDefault();
55
- e.currentTarget.click();
56
- } : undefined, "aria-label": ariaHidden ? undefined : ariaLabel ?? defaultLabel, "aria-hidden": ariaHidden || undefined,
57
- // 누를 수 없는 점도 이름이 있으면 그림(img)으로 — 역할 없는 span 의 aria-label 은 낭독기가 버려 "선택됨" 이 안 들렸다(bar 와 같게)
58
- role: onClick ? 'button' : (ariaHidden ? undefined : 'img'), tabIndex: onClick ? 0 : undefined, children: [number !== undefined && number, number === undefined && dotIcon === 'check' && _jsx(CheckIcon, {}), number === undefined && dotIcon === 'remove' && _jsx(RemoveIcon, {}), number === undefined && dotIcon === 'minus' && _jsx(MinusIcon, {})] }));
16
+ const {
17
+ /* **기본값이 알약이다**(2026-10-28) — 전 기본값이 그리던 그림 그대로라, `type` 을 안 적은
18
+ 자리(코어·앱 합쳐 쉰 곳 남짓)는 가만히 있는다. */
19
+ type = 'dot', size, className = '', 'aria-label': ariaLabel, 'aria-hidden': ariaHidden, } = props;
20
+ /**
21
+ * **옛 원형 뱃지의 프롭이 오면 한 번 이른다**(2026-10-28).
22
+ *
23
+ * `dot` · `bar` 가 **글자는 그대로 두고 뜻만** 한 칸씩 옮겨 앉았다. 그래서 안 고친 자리도
24
+ * 타입이 멀쩡해 `tsc` 가 아무 말도 안 한다 — 화면이 조용히 다른 그림을 그린다.
25
+ * 옛 원형은 `icon` · `number` · `position` · `animate` · `onClick` 가운데 하나는 꼭 줘야
26
+ * 쓸모가 있었으므로, **그 프롭이 보이면 안 고친 자리**다.
27
+ */
28
+ if (props.icon !== undefined || props.number !== undefined || props.position !== undefined
29
+ || props.animate !== undefined || props.onClick !== undefined) {
30
+ devWarnOnce('badge-circle-props', '[ihab/core] Badge 가 원형 뱃지의 프롭(icon · number · position · animate · onClick)을 받았습니다. ' +
31
+ '원형은 이제 CircleBadge 가 그립니다 — Badge 의 dot 는 작은 알약 이름표입니다. ' +
32
+ '그 자리를 <CircleBadge …/> 로 바꾸세요.');
59
33
  }
60
- // ── bar (텍스트) ────────────────────────────────────────────────────────
34
+ // ── 그리기 — `dot`(알약) · `bar`(띠) 가 같은 색·같은 자를 쓴다 ───────────
61
35
  const { label, children, variant = 'default', fill = 'filled', minWidth, iconLeft, iconRight, color } = props;
62
- // bar는 문자열 크기만 쓴다 — dot용 숫자가 들어오면 기본값(medium)으로 떨어뜨린다.
36
+ /* 넓게 눕는 띠인가 — 아니면 작은 알약이다(기본) */
37
+ const isBand = type === 'bar';
38
+ // 문자열 크기만 쓴다 — 옛 원형의 숫자가 들어오면 기본값(medium)으로 떨어뜨린다.
63
39
  const barSize = typeof size === 'number' ? 'medium' : size ?? 'medium';
64
40
  // medium·large는 볼드 계열(b) — 배지는 짧은 라벨이라 본문보다 또렷해야 눈에 잡힌다
65
41
  const sizeFont = { small: 'caption-2b', medium: 'body-3b', large: 'body-2b' }[barSize] ?? 'body-2b';
66
42
  const iconSize = { small: 12, medium: 14, large: 16 }[barSize] ?? 14;
67
- const cls = cx('badge', `badge--${variant}`, `badge--${barSize}`, fill !== 'filled' ? `badge--${fill}` : '', sizeFont, className);
43
+ const cls = cx('badge', isBand ? 'badge--bar' : '', `badge--${variant}`, `badge--${barSize}`, fill !== 'filled' ? `badge--${fill}` : '', sizeFont, className);
68
44
  // color는 variant가 정하는 --badge-color를 덮는다. 토큰 이름('--color-main')을 주면
69
45
  // var()로 감싸 준다(Button의 color prop과 같은 규칙). filled/soft/outline 모두
70
46
  // 이 변수 하나만 보므로 fill과 조합이 자유롭다.
@@ -4,7 +4,7 @@ import { useCallback, useId, useMemo, useState, useRef, useEffect } from 'react'
4
4
  import { createPortal } from 'react-dom';
5
5
  import './BottomNav.css';
6
6
  import Button from './Button';
7
- import Badge from './Badge';
7
+ import CircleBadge from './CircleBadge';
8
8
  import MenuTooltip from './Tooltip/MenuTooltip';
9
9
  // .tooltip__content(메뉴 표면)를 직접 쓰므로 정의 파일을 명시적으로 가져온다.
10
10
  // Tooltip.tsx만 이 CSS를 import하는데 BottomNav는 그 컴포넌트를 거치지 않아,
@@ -154,6 +154,6 @@ export default function BottomNav({ items = [], activeKey, onChange, appMode, on
154
154
  _jsxs("span", { className: "bottom-nav__slot", children: [_jsx(Button, { htmlType: "button", size: 52, type: "dot", icon: it.icon, ariaLabel: nameWithCount(it.label, count), selected: !!it.key && it.key === activeKey, disabled: it.state === 'disabled', className: "bottom-nav-item", onClick: () => { if (it.key) {
155
155
  onChange?.(it.key);
156
156
  scrollNavTargetToTop(scrollContainer, 'BottomNav');
157
- } } }), count > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(Badge, { type: "dot", position: "top-right", number: Math.min(count, 99), size: 24 }) }))] }, it.key ?? `__slot-${i}`));
158
- }) }), showMore && (_jsxs(_Fragment, { children: [_jsx("div", { className: "bottom-nav__divider", "aria-hidden": "true" }), _jsx("div", { className: "bottom-nav__right", children: _jsxs("div", { ref: moreRef, className: "bottom-nav__slot", children: [_jsx(Button, { htmlType: "button", size: 52, type: "dot", icon: activeMore?.icon ?? 'ellipsis', ariaLabel: visibleCount(activeMore?.label ?? t('nav.more', '더보기'), moreBadge), selected: !!activeMore, className: "bottom-nav-item", onClick: handleToggleMore, "aria-expanded": moreOpen, "aria-controls": moreOpen ? moreMenuId : undefined }), moreBadge > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(Badge, { type: "dot", position: "top-right", number: Math.min(moreBadge, 99), size: 24 }) })), moreOpen && createPortal(_jsx("div", { id: moreMenuId, role: "group", "aria-label": t('nav.moreMenu', '더보기 메뉴'), className: withLegacy("tooltip__content"), style: menuStyle, ref: menuRef, children: _jsx(MenuTooltip, { columns: moreColumns, onClose: handleCloseMore }) }), document.body)] }) })] }))] }));
157
+ } } }), count > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(CircleBadge, { position: "top-right", number: Math.min(count, 99), size: 24 }) }))] }, it.key ?? `__slot-${i}`));
158
+ }) }), showMore && (_jsxs(_Fragment, { children: [_jsx("div", { className: "bottom-nav__divider", "aria-hidden": "true" }), _jsx("div", { className: "bottom-nav__right", children: _jsxs("div", { ref: moreRef, className: "bottom-nav__slot", children: [_jsx(Button, { htmlType: "button", size: 52, type: "dot", icon: activeMore?.icon ?? 'ellipsis', ariaLabel: visibleCount(activeMore?.label ?? t('nav.more', '더보기'), moreBadge), selected: !!activeMore, className: "bottom-nav-item", onClick: handleToggleMore, "aria-expanded": moreOpen, "aria-controls": moreOpen ? moreMenuId : undefined }), moreBadge > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(CircleBadge, { position: "top-right", number: Math.min(moreBadge, 99), size: 24 }) })), moreOpen && createPortal(_jsx("div", { id: moreMenuId, role: "group", "aria-label": t('nav.moreMenu', '더보기 메뉴'), className: withLegacy("tooltip__content"), style: menuStyle, ref: menuRef, children: _jsx(MenuTooltip, { columns: moreColumns, onClose: handleCloseMore }) }), document.body)] }) })] }))] }));
159
159
  }
@@ -1,32 +1,66 @@
1
- import { type ReactNode } from 'react';
1
+ import { type ReactNode, type MouseEvent } from 'react';
2
2
  import './CircleBadge.css';
3
3
  import './Badge.css';
4
4
  /** 부모 코너 배치. inline 은 흐름 배치. @public */
5
5
  export type CircleBadgePosition = 'top-left' | 'top-right' | 'inline';
6
- /** 크기 스케일 — Button/Badge dot 과 동일. @public */
6
+ /** 크기 스케일 — Button 과 같은 숫자 자. @public */
7
7
  export type CircleBadgeSize = 24 | 32 | 40;
8
+ /** 원 안에 그릴 아이콘. @public */
9
+ export type CircleBadgeIcon = 'check' | 'remove' | 'minus';
8
10
  /** @public */
9
11
  export interface CircleBadgeProps {
10
- /** 원 안에 표시할 내용(R/L·숫자·짧은 문자). */
11
- children: ReactNode;
12
- /** 부모(position:relative) 코너 배치. 기본 좌상단. inline 이면 흐름 배치. */
12
+ /**
13
+ * 원 안에 그릴 것 — `R`·`L` 처럼 짧은 글자. 안 주면 `number` 를, 그것도 없으면
14
+ * `icon`(기본 `check`)을 그린다.
15
+ */
16
+ children?: ReactNode;
17
+ /**
18
+ * 아이콘 종류. `children` 도 `number` 도 없으면 이것으로 그리고, 이것도 없으면 `check` 다.
19
+ * - `check` — 선택·완료(파란 체크)
20
+ * - `remove` — 제거(빨간 ×)
21
+ * - `minus` — 제외(회색 —)
22
+ */
23
+ icon?: CircleBadgeIcon;
24
+ /** 숫자를 그린다 — `icon` 대신이다. */
25
+ number?: number;
26
+ /** 부모(`position: relative`) 모서리 배치. 기본 좌상단. `inline` 이면 흐름 배치. */
13
27
  position?: CircleBadgePosition;
14
- /** 크기 스케일. 기본 24. */
28
+ /** 크기 자. 기본 24. */
15
29
  size?: CircleBadgeSize;
30
+ /**
31
+ * 등장 애니메이션. 기본 꺼짐.
32
+ * 선택·완료처럼 **그 순간** 나타나는 자리에서 켠다. 목록처럼 처음부터 떠 있는 자리에는
33
+ * 끄는 편이 낫다(열 때마다 다 같이 튄다). 모션 최소화 설정에서는 저절로 꺼진다.
34
+ */
35
+ animate?: boolean;
36
+ /** 누를 수 있게 한다 — 주면 진짜 단추처럼 자판으로도 눌린다. */
37
+ onClick?: (e: MouseEvent) => void;
38
+ /**
39
+ * 낭독기가 읽을 이름. 안 주면 그림에 따라 '선택됨'·'제거'·'제외'·'N번째 선택' 으로 짓는다.
40
+ */
41
+ 'aria-label'?: string;
42
+ /**
43
+ * 낭독기에서 숨긴다. 개수를 곁의 단추 이름에 이미 넣었을 때 쓴다 —
44
+ * 예: `SideNav`·`BottomNav` 는 단추 이름을 "숙제, 3개" 로 짓고 이 뱃지는 숨긴다.
45
+ * 주면 `aria-label` 보다 이긴다.
46
+ */
47
+ 'aria-hidden'?: boolean;
16
48
  className?: string;
17
49
  }
18
50
  /**
19
- * 원형 식별 배지 — 짧은 문자/숫자를 원 안에 보여준다.
51
+ * **원형 뱃지** — 숫자·체크·×·짧은 글자를 원 안에 보여 준다.
20
52
  *
21
- * `Badge type="dot"` 은 숫자(number)나 아이콘(check/remove/minus)만 그리므로,
22
- * R/L 처럼 임의 문자를 원에 담아야 할 때 이 컴포넌트를 쓴다. 스타일은 Badge 의
23
- * `.circle-badge` 를 그대로 재사용한다(파란 원 + 흰 글자).
53
+ * **2026-10-28 에 이 컴포넌트가 원형을 통째로 받았다**(사용자 지시). 전에는 같은 그림을
54
+ * `Badge type="dot"` 도 그려, **두 자리가 같은 것을 그리고** 있었다. 이제 원형은 여기 하나다 —
55
+ * `Badge` 의 `dot` 은 **작은 알약 이름표**를 뜻한다.
24
56
  *
25
57
  * @example
26
58
  * <div style={{ position: 'relative' }}>
27
59
  * <input />
28
60
  * <CircleBadge>R</CircleBadge>
61
+ * <CircleBadge number={3} size={24} aria-hidden />
62
+ * <CircleBadge icon="remove" onClick={remove} />
29
63
  * </div>
30
64
  * @public
31
65
  */
32
- export default function CircleBadge({ children, position, size, className, }: CircleBadgeProps): import("react").JSX.Element;
66
+ export default function CircleBadge({ children, icon, number, position, size, animate, onClick, 'aria-label': ariaLabel, 'aria-hidden': ariaHidden, className, }: CircleBadgeProps): import("react").JSX.Element;
@@ -1,21 +1,72 @@
1
- import { jsx as _jsx } from "react/jsx-runtime";
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useTranslation } from 'react-i18next';
2
4
  import { cx } from '../utils/cx';
3
5
  import './CircleBadge.css';
4
6
  import './Badge.css';
7
+ function CheckIcon() {
8
+ return (_jsx("svg", { viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.2, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("polyline", { points: "2,6 5,9 10,3" }) }));
9
+ }
10
+ function RemoveIcon() {
11
+ return (_jsxs("svg", { viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.2, strokeLinecap: "round", "aria-hidden": "true", children: [_jsx("line", { x1: "3", y1: "3", x2: "9", y2: "9" }), _jsx("line", { x1: "9", y1: "3", x2: "3", y2: "9" })] }));
12
+ }
13
+ function MinusIcon() {
14
+ return (_jsx("svg", { viewBox: "0 0 12 12", fill: "none", stroke: "currentColor", strokeWidth: 2.2, strokeLinecap: "round", "aria-hidden": "true", children: _jsx("line", { x1: "2.5", y1: "6", x2: "9.5", y2: "6" }) }));
15
+ }
5
16
  /**
6
- * 원형 식별 배지 — 짧은 문자/숫자를 원 안에 보여준다.
17
+ * **원형 뱃지** — 숫자·체크·×·짧은 글자를 원 안에 보여 준다.
7
18
  *
8
- * `Badge type="dot"` 은 숫자(number)나 아이콘(check/remove/minus)만 그리므로,
9
- * R/L 처럼 임의 문자를 원에 담아야 할 때 이 컴포넌트를 쓴다. 스타일은 Badge 의
10
- * `.circle-badge` 를 그대로 재사용한다(파란 원 + 흰 글자).
19
+ * **2026-10-28 에 이 컴포넌트가 원형을 통째로 받았다**(사용자 지시). 전에는 같은 그림을
20
+ * `Badge type="dot"` 도 그려, **두 자리가 같은 것을 그리고** 있었다. 이제 원형은 여기 하나다 —
21
+ * `Badge` 의 `dot` 은 **작은 알약 이름표**를 뜻한다.
11
22
  *
12
23
  * @example
13
24
  * <div style={{ position: 'relative' }}>
14
25
  * <input />
15
26
  * <CircleBadge>R</CircleBadge>
27
+ * <CircleBadge number={3} size={24} aria-hidden />
28
+ * <CircleBadge icon="remove" onClick={remove} />
16
29
  * </div>
17
30
  * @public
18
31
  */
19
- export default function CircleBadge({ children, position = 'top-left', size = 24, className = '', }) {
20
- return (_jsx("span", { className: cx('circle-badge', 'circle-badge--number', `circle-badge--${size}`, `circle-badge--${position}`, className), children: children }));
32
+ export default function CircleBadge({ children, icon, number, position = 'top-left', size = 24, animate = false, onClick, 'aria-label': ariaLabel, 'aria-hidden': ariaHidden, className = '', }) {
33
+ const { t } = useTranslation();
34
+ /* 아이콘을 안 주면 체크다 — 클래스(파란 바탕)와 기본 이름이 이미 체크로 가는데 그리는 쪽만
35
+ `icon === 'check'` 을 보던 때가 있어 **체크 없는 파란 원**이 났다. 셋이 같은 값을 본다. */
36
+ const dotIcon = icon ?? 'check';
37
+ const hasNumber = number !== undefined;
38
+ /* 글자를 직접 주면 숫자 꼴(흰 글자)로 그린다 — `R`·`L` 이 그 자리다 */
39
+ const variant = (children !== undefined || hasNumber) ? 'number' : dotIcon;
40
+ /**
41
+ * 이름을 **스스로 지을 자리와 안 지을 자리**를 가른다.
42
+ *
43
+ * `children` 으로 글자를 직접 주면 **그 글자가 곧 이름**이다 — `R` 은 "R" 로 읽혀야 한다.
44
+ * 거기에 이름을 지어 얹으면 글자를 덮어 버린다(놀이터에서 `R`·`1` 이 전부 **"선택됨"** 으로
45
+ * 읽히는 것을 보고 알았다 — 시험은 아이콘 쪽만 보고 있어 못 잡았다).
46
+ * 그림(아이콘·숫자)일 때만 짓는다. 그때는 그릴 글자가 없어서 이름이 없으면 아무것도 안 들린다.
47
+ */
48
+ const defaultLabel = children !== undefined
49
+ ? undefined
50
+ : hasNumber
51
+ ? t('badge.nthSelected', { n: number, defaultValue: '{{n}}번째 선택' })
52
+ : {
53
+ check: t('badge.selected', '선택됨'),
54
+ remove: t('badge.remove', '제거'),
55
+ minus: t('badge.exclude', '제외'),
56
+ }[dotIcon];
57
+ const label = ariaHidden ? undefined : ariaLabel ?? defaultLabel;
58
+ return (_jsxs("span", { className: cx('circle-badge', `circle-badge--${variant}`, `circle-badge--${size}`, `circle-badge--${position}`, animate ? 'circle-badge--animate' : '', onClick ? 'circle-badge--clickable' : '', className), onClick: onClick,
59
+ /* `<span role="button">` 은 브라우저가 Enter·Space 를 눌림으로 바꿔 주지 않는다 —
60
+ DOM 이 **진짜 클릭을 내게** 해야 이벤트의 target·currentTarget 도 실제와 같다. */
61
+ onKeyDown: onClick ? (e) => {
62
+ if (e.key !== 'Enter' && e.key !== ' ')
63
+ return;
64
+ e.preventDefault();
65
+ e.currentTarget.click();
66
+ } : undefined, "aria-label": label, "aria-hidden": ariaHidden || undefined,
67
+ /* 누를 수 없는 원도 이름이 있으면 그림(img)으로 — 역할 없는 span 의 `aria-label` 은
68
+ 낭독기가 버려 "선택됨" 이 안 들렸다 */
69
+ /* 이름이 있을 때만 그림(img) — 역할 없는 span 의 `aria-label` 은 낭독기가 버린다.
70
+ 글자를 직접 준 원은 이름이 없으니 역할도 안 붙인다(글자가 그대로 읽힌다). */
71
+ role: onClick ? 'button' : (label ? 'img' : undefined), tabIndex: onClick ? 0 : undefined, children: [children ?? (hasNumber ? number : null), children === undefined && !hasNumber && dotIcon === 'check' && _jsx(CheckIcon, {}), children === undefined && !hasNumber && dotIcon === 'remove' && _jsx(RemoveIcon, {}), children === undefined && !hasNumber && dotIcon === 'minus' && _jsx(MinusIcon, {})] }));
21
72
  }
@@ -5,7 +5,7 @@ import { useTranslation } from 'react-i18next';
5
5
  import { useMediaQuery } from '../hooks';
6
6
  import BottomNav from './BottomNav';
7
7
  import Button from './Button';
8
- import Badge from './Badge';
8
+ import CircleBadge from './CircleBadge';
9
9
  import MenuTooltip from './Tooltip/MenuTooltip';
10
10
  import { useAnchoredMenu, anchoredMenuZIndex } from '../hooks/useAnchoredMenu';
11
11
  import { createPortal } from 'react-dom';
@@ -134,7 +134,7 @@ export default function Header({ activeKey, onChange, items, malgwiItems: _malgw
134
134
  손대지 않는다 — 거기에 다른 뜻을 겹치면 맞는 세 쓰임이 서로를 막는다). */
135
135
  ariaLabel: onNotification && unreadCount && unreadCount > 0
136
136
  ? t('nav.badgeInsideLabel', { label: t('header.menuOpen', '메뉴 열기'), count: unreadCount, defaultValue: '{{label}}, 안에 알림 {{count}}개' })
137
- : t('header.menuOpen', '메뉴 열기'), onClick: toggleUtilMenu, "aria-expanded": utilOpen, "aria-controls": utilOpen ? utilMenuId : undefined }), !!onNotification && !!unreadCount && unreadCount > 0 && (_jsx(Badge, { type: "dot", number: Math.min(unreadCount, 99), size: 24, "aria-hidden": true })), utilOpen && createPortal(_jsx("div", { id: utilMenuId, role: "group", "aria-label": t('header.utilMenu', '유틸리티 메뉴'), className: withLegacy("tooltip__content"), style: utilMenuStyle, ref: utilMenuRef, children: _jsx(MenuTooltip, { columns: utilColumns, onClose: closeUtilMenu }) }), document.body)] })] }), _jsx(SideNav, { scrollContainer: scrollContainer, items: items, activeKey: activeKey ?? undefined, onChange: onChange, unreadCount: unreadCount, onDebug: onDebug, onNotification: onNotification, onAccount: onAccount, onSetting: onSetting, onHelp: onHelp, onFeedback: onFeedback, appMode: appMode, onAppModeChange: onAppModeChange }), isMobile && _jsx(BottomNav, { items: bottomItems, activeKey: activeKey ?? undefined, onChange: handleBottomChange, scrollContainer: scrollContainer, appMode: appMode, onAppModeChange: onAppModeChange })] }));
137
+ : t('header.menuOpen', '메뉴 열기'), onClick: toggleUtilMenu, "aria-expanded": utilOpen, "aria-controls": utilOpen ? utilMenuId : undefined }), !!onNotification && !!unreadCount && unreadCount > 0 && (_jsx(CircleBadge, { number: Math.min(unreadCount, 99), size: 24, "aria-hidden": true })), utilOpen && createPortal(_jsx("div", { id: utilMenuId, role: "group", "aria-label": t('header.utilMenu', '유틸리티 메뉴'), className: withLegacy("tooltip__content"), style: utilMenuStyle, ref: utilMenuRef, children: _jsx(MenuTooltip, { columns: utilColumns, onClose: closeUtilMenu }) }), document.body)] })] }), _jsx(SideNav, { scrollContainer: scrollContainer, items: items, activeKey: activeKey ?? undefined, onChange: onChange, unreadCount: unreadCount, onDebug: onDebug, onNotification: onNotification, onAccount: onAccount, onSetting: onSetting, onHelp: onHelp, onFeedback: onFeedback, appMode: appMode, onAppModeChange: onAppModeChange }), isMobile && _jsx(BottomNav, { items: bottomItems, activeKey: activeKey ?? undefined, onChange: handleBottomChange, scrollContainer: scrollContainer, appMode: appMode, onAppModeChange: onAppModeChange })] }));
138
138
  }
139
139
  /**
140
140
  * `Header`의 alias입니다. 프로젝트 내 `Header`라는 이름이 이미 사용 중일 때 충돌 없이 임포트할 수 있습니다.