@ihabdevteam/core 0.438.0 → 0.441.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 (54) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.md +3 -3
  3. package/dist/components.cjs.js +190 -180
  4. package/dist/components.esm.css +1 -1
  5. package/dist/hooks.cjs.js +5 -5
  6. package/dist/i18n.cjs.js +3 -3
  7. package/dist/ihabdevteam-core.cjs.js +196 -186
  8. package/dist/ihabdevteam-core.d.ts +435 -5
  9. package/dist/packages/core/src/components/Breadcrumb.css +52 -0
  10. package/dist/packages/core/src/components/Breadcrumb.d.ts +19 -1
  11. package/dist/packages/core/src/components/Breadcrumb.js +12 -4
  12. package/dist/packages/core/src/components/Button.css +9 -2
  13. package/dist/packages/core/src/components/CardSection.css +26 -0
  14. package/dist/packages/core/src/components/CardSection.d.ts +32 -0
  15. package/dist/packages/core/src/components/CardSection.js +23 -0
  16. package/dist/packages/core/src/components/FolderGrid.css +28 -0
  17. package/dist/packages/core/src/components/FolderGrid.d.ts +47 -0
  18. package/dist/packages/core/src/components/FolderGrid.js +68 -0
  19. package/dist/packages/core/src/components/FolderHead.css +8 -0
  20. package/dist/packages/core/src/components/FolderHead.d.ts +42 -0
  21. package/dist/packages/core/src/components/FolderHead.js +62 -0
  22. package/dist/packages/core/src/components/FolderSearchSections.d.ts +25 -0
  23. package/dist/packages/core/src/components/FolderSearchSections.js +18 -0
  24. package/dist/packages/core/src/components/FolderTreeButton.css +2 -0
  25. package/dist/packages/core/src/components/FolderTreeButton.d.ts +34 -0
  26. package/dist/packages/core/src/components/FolderTreeButton.js +44 -0
  27. package/dist/packages/core/src/components/Popup/ConfirmPopup.d.ts +8 -2
  28. package/dist/packages/core/src/components/Popup/ConfirmPopup.js +3 -3
  29. package/dist/packages/core/src/components/Tooltip/FolderTreeTooltip.css +99 -0
  30. package/dist/packages/core/src/components/Tooltip/FolderTreeTooltip.d.ts +60 -0
  31. package/dist/packages/core/src/components/Tooltip/FolderTreeTooltip.js +81 -0
  32. package/dist/packages/core/src/components/Tooltip/Tooltip.d.ts +6 -0
  33. package/dist/packages/core/src/components/Tooltip/Tooltip.js +10 -4
  34. package/dist/packages/core/src/components.d.ts +12 -0
  35. package/dist/packages/core/src/components.js +8 -0
  36. package/dist/packages/core/src/hooks/useCardDragToGroup.d.ts +33 -0
  37. package/dist/packages/core/src/hooks/useCardDragToGroup.js +52 -0
  38. package/dist/packages/core/src/hooks/useFolderBrowse.d.ts +30 -0
  39. package/dist/packages/core/src/hooks/useFolderBrowse.js +38 -0
  40. package/dist/packages/core/src/hooks.d.ts +2 -0
  41. package/dist/packages/core/src/hooks.js +3 -0
  42. package/dist/packages/core/src/i18n/locales/en.json +10 -0
  43. package/dist/packages/core/src/i18n/locales/ko.json +9 -0
  44. package/dist/packages/core/src/utils/folderMenu.d.ts +27 -0
  45. package/dist/packages/core/src/utils/folderMenu.js +19 -0
  46. package/dist/packages/core/src/utils/folderPath.d.ts +50 -0
  47. package/dist/packages/core/src/utils/folderPath.js +98 -0
  48. package/dist/packages/core/src/utils/lucideIconSet.js +4 -0
  49. package/dist/packages/core/src/utils.d.ts +3 -0
  50. package/dist/packages/core/src/utils.js +3 -0
  51. package/dist/packages/core/src/version.d.ts +1 -1
  52. package/dist/packages/core/src/version.js +1 -1
  53. package/dist/utils.cjs.js +175 -165
  54. package/package.json +3 -3
@@ -2,7 +2,7 @@ import { ComponentType } from 'react';
2
2
  import { Context } from 'react';
3
3
  import { CSSProperties } from 'react';
4
4
  import { Dispatch } from 'react';
5
- import type { DragEvent as DragEvent_2 } from 'react';
5
+ import { DragEvent as DragEvent_2 } from 'react';
6
6
  import type { ElementType } from 'react';
7
7
  import { FC } from 'react';
8
8
  import { FocusEvent as FocusEvent_2 } from 'react';
@@ -753,7 +753,7 @@ export declare interface BrandLogoProps {
753
753
  * 앞 항목은 `href` 가 있으면 링크, `onClick` 만 있으면 단추, 둘 다 없으면 글자다.
754
754
  * @public
755
755
  */
756
- export declare function Breadcrumb({ items, className }: BreadcrumbProps): JSX.Element;
756
+ export declare function Breadcrumb({ items, size, className }: BreadcrumbProps): JSX.Element;
757
757
 
758
758
  /** @public */
759
759
  export declare interface BreadcrumbItem {
@@ -766,11 +766,29 @@ export declare interface BreadcrumbItem {
766
766
  target?: string;
767
767
  /** 선택. 링크의 rel. `target="_blank"` 이고 안 주면 `noopener noreferrer`. */
768
768
  rel?: string;
769
+ /**
770
+ * **마지막 항목(지금 쪽)에 메뉴를 단다** — 주면 이름과 ▾ 가 **한 단추**로 서고, 누르면 그 단추를 넘겨 부른다
771
+ * (메뉴는 부르는 쪽이 그 단추에 붙여 띄운다). 구글 드라이브의 「폴더 이름 ▾」 꼴이다
772
+ * (말귀 청 (430) 보탬, 사장님 지시 2026-11-13 "클릭 되도록"). 마지막이 아닌 항목에서는 무시한다.
773
+ */
774
+ menu?: {
775
+ onOpen: (anchor: HTMLElement) => void;
776
+ /** 메뉴가 열려 있나 — `aria-expanded` 로 말한다 */
777
+ expanded?: boolean;
778
+ /** 낭독기 이름. 안 주면 항목의 `label` */
779
+ ariaLabel?: string;
780
+ };
769
781
  }
770
782
 
771
783
  /** @public */
772
784
  export declare interface BreadcrumbProps {
773
785
  items: BreadcrumbItem[];
786
+ /**
787
+ * 글자 크기. 기본 `small` — 전부터 있던 꼴 그대로다(`body-3` · 갈림표 14).
788
+ * `medium` 은 두 단 크다(`body-1` · 갈림표 18 — 처음엔 `body-2` 였는데 사장님이 보시고 "폰트 크기가 작아 더 키워줘") — 길을 쪽의 둘째 제목처럼 도구줄 위에 세울 때 쓴다
789
+ * (말귀 청 (430), 사장님 지시 2026-11-13 "브래드 크럼에 size prop 넣고 지금건 small. 미디움으로 만들어서").
790
+ */
791
+ size?: 'small' | 'medium';
774
792
  className?: string;
775
793
  }
776
794
 
@@ -1224,6 +1242,13 @@ export declare function Calendar({ visits, onVisitClick, onVisitMove, onDayClick
1224
1242
  /** 다시 구워도 되는 꼴인가 — **움직이는 GIF 는 뺀다**(캔버스로 그리면 첫 장만 남는다) */
1225
1243
  export declare function canCompressImageType(type: string): boolean;
1226
1244
 
1245
+ /**
1246
+ * 폴더 `from` 을 `toParent` 안으로 옮길 수 있나 — 제 자신 · 제 아래로는 못 들어가고, 이미 그 자리에 있으면 옮길 것이 없다.
1247
+ * (같은 이름이 그 자리에 이미 있는지는 부르는 쪽이 본다 — 있는 폴더를 아는 것은 그쪽이다.)
1248
+ * @public
1249
+ */
1250
+ export declare const canMoveFolder: (from: string, toParent: string | null) => boolean;
1251
+
1227
1252
  /** 카테고리별 capability 메타 + 소속 그룹. group은 유형↔카드 스텝 계열 판정의 단일 소스. */
1228
1253
  export declare const CAPABILITY: Record<WordTrainingTypeKey, {
1229
1254
  difficulty: boolean;
@@ -1231,6 +1256,37 @@ export declare const CAPABILITY: Record<WordTrainingTypeKey, {
1231
1256
  group: WordTrainingGroup;
1232
1257
  }>;
1233
1258
 
1259
+ /**
1260
+ * **카드를 끌어 묶음(폴더)에 놓는다** — HTML5 끌어 놓기를 한 벌로 쥔다(말귀 청 (437) ㉮ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
1261
+ *
1262
+ * 카드 요소에는 `cardProps(payload)` 를, 놓일 자리(폴더 칸 등)에는 `groupProps(key)` 를 얹는다. 실제로 옮기는 일은
1263
+ * `onDrop(payload, key)` 에 맡긴다(열쇠 → 묶음 찾기는 부르는 쪽 몫). `dragging` · `draggingId` · `dragOverKey` 로 그리는 꼴을 바꾼다.
1264
+ *
1265
+ * · 기본은 `T = string`(카드 id 가 곧 짐)이다. 여러 종류를 한 화면에서 다루면 `T` 를 객체로 두고 `getId` 로 id 를 뽑고,
1266
+ * `groupProps` 의 `accept` 로 자리마다 받을 짐을 가린다.
1267
+ * · 강조(`dragOverKey`)는 `onDragEnter` 와 `onDragOver` 양쪽에서 건다 — 자리가 `onDragEnter` 를 안 넘기는 조각이어도 선다.
1268
+ * · 자식으로 옮겨 가며 나는 `dragleave` 는 버린다 — `relatedTarget` 이 자리 **밖**일 때만 강조를 끈다.
1269
+ *
1270
+ * `FolderGrid` 의 폴더 칸 끌기도 이 훅으로 선다(전에는 같은 상태를 제 안에서 다시 지었다).
1271
+ * @public
1272
+ */
1273
+ export declare interface CardDragToGroup<T> {
1274
+ dragging: T | null;
1275
+ draggingId: string | null;
1276
+ dragOverKey: string | null;
1277
+ cardProps: (payload: T) => {
1278
+ draggable: true;
1279
+ onDragStart: (e: DragEvent_2<HTMLElement>) => void;
1280
+ onDragEnd: () => void;
1281
+ };
1282
+ groupProps: (groupKey: string, accept?: (payload: T) => boolean) => {
1283
+ onDragOver: (e: DragEvent_2<HTMLElement>) => void;
1284
+ onDragEnter: () => void;
1285
+ onDragLeave: (e: DragEvent_2<HTMLElement>) => void;
1286
+ onDrop: (e: DragEvent_2<HTMLElement>) => void;
1287
+ };
1288
+ }
1289
+
1234
1290
  /** @public */
1235
1291
  declare function CardOrderStep({ _stepIndex, _totalSteps, ...rest }: StepWrapperProps): JSX.Element;
1236
1292
 
@@ -1241,6 +1297,38 @@ declare function CardOrderStep({ _stepIndex, _totalSteps, ...rest }: StepWrapper
1241
1297
  */
1242
1298
  export declare function cardQuestionTitle(typeKey: string | undefined, item: Record<string, unknown>, parts: string[]): string;
1243
1299
 
1300
+ /**
1301
+ * **카드가 서는 자리** — 회색 그룹 칸 없이 카드가 쪽 바탕에 바로 선다(말귀 청 (437) ㉮ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
1302
+ *
1303
+ * 전에는 목록마다 `TrainingCardGroup`(회색 칸 + 제목 + 수)이 감쌌다. 말귀 사장님 지시로 그 칸을 걷었다(*"숙제관리, 고객별 숙제
1304
+ * 페이지, 등등 그룹 ui 를 사용하고 있는곳이 많아. 모두 정리해주고"*) — 목록이 하나뿐인 자리에서는 칸의 제목과 수가 위의 탭 ·
1305
+ * 도구줄과 **같은 말을 한 번 더** 했고, 화면마다 칸이 있고 없고가 갈려 같은 카드가 다르게 보였다.
1306
+ *
1307
+ * · **목록이 하나뿐이면 제목을 안 준다** — 무엇의 목록인지는 탭과 도구줄이 이미 말한다.
1308
+ * · **여러 묶음을 한 화면에 나눠 세울 때만 제목을 준다**(진행 중 / 완료 · 훈련 종류별 · 폴더별) — 가르는 것이 정보인 자리다.
1309
+ * 제목은 가벼운 한 줄(이름 + 수)이고 칸을 두르지 않는다.
1310
+ * · 비었을 때의 말(`emptyContent`)은 **목록 자리에** 선다 — 못 받음 · 못 찾음 · 아직 없음을 갈라 말하던 것 그대로.
1311
+ * @public
1312
+ */
1313
+ export declare function CardSection({ title, count, titleLevel, actions, empty, emptyContent, className, children }: CardSectionProps): JSX.Element;
1314
+
1315
+ /** @public */
1316
+ export declare interface CardSectionProps {
1317
+ /** 묶음의 이름 — 한 화면에 묶음이 여럿일 때만 준다 */
1318
+ title?: ReactNode;
1319
+ /** 그 묶음의 수(쪽에 선 수가 아니라 전부) */
1320
+ count?: number;
1321
+ /** 제목의 머리글 급 — 쪽에 바로 서면 2, 창 안이면 3 */
1322
+ titleLevel?: 2 | 3 | 4;
1323
+ /** 제목 줄 오른쪽에 설 것 */
1324
+ actions?: ReactNode;
1325
+ /** 비었나 — 참이면 목록 대신 `emptyContent` 가 목록 자리에 선다 */
1326
+ empty?: boolean;
1327
+ emptyContent?: ReactNode;
1328
+ className?: string;
1329
+ children?: ReactNode;
1330
+ }
1331
+
1244
1332
  /** @public */
1245
1333
  export declare function CardStep({ _stepIndex, _totalSteps, ...rest }: StepWrapperProps): JSX.Element;
1246
1334
 
@@ -1860,8 +1948,14 @@ export declare function ConfirmPopup(props: ConfirmPopupProps): JSX.Element;
1860
1948
  export declare interface ConfirmPopupProps {
1861
1949
  /** 팝업 제목 */
1862
1950
  title: ReactNode;
1863
- /** 본문 메시지 */
1864
- message: ReactNode;
1951
+ /**
1952
+ * 제목 아래 한 줄(창 머리의 부제) — 안내 글을 본문이 아니라 **머리**에 둘 때 쓴다(코어 `Popup.subtitle` 로 간다).
1953
+ * 입력칸 하나를 띄우는 창처럼 본문 글이 따로 필요 없으면 이것만 주고 `message` 는 비운다
1954
+ * (말귀 청 (431), 사장님 지시 2026-11-13 — 폴더 추가 창의 안내 글을 고르시며 "sub로").
1955
+ */
1956
+ subtitle?: string;
1957
+ /** 본문 메시지. `subtitle` 로 말을 다 했으면 안 줘도 된다 — 그때는 문단이 자리를 안 차지한다 */
1958
+ message?: ReactNode;
1865
1959
  /**
1866
1960
  * details·message 위(본문 최상단)에 놓을 것 — 미리보기 카드·표 등.
1867
1961
  *
@@ -2131,7 +2225,7 @@ export declare function copyText(text: string): Promise<boolean>;
2131
2225
  *
2132
2226
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
2133
2227
  */
2134
- export declare const CORE_VERSION = "0.438.0";
2228
+ export declare const CORE_VERSION = "0.441.0";
2135
2229
 
2136
2230
  /** @public */
2137
2231
  declare const coreDefault: Record<string, unknown>;
@@ -3077,6 +3171,289 @@ export declare type FlowState = {
3077
3171
 
3078
3172
  export declare function fmtBytes(n: number): string;
3079
3173
 
3174
+ /** @public `parent` 바로 아래의 폴더들(한 층만) — `parent` 가 `null` 이면 맨 위의 폴더들. 받은 차례 그대로 */
3175
+ export declare function folderChildren(paths: readonly string[], parent: string | null): string[];
3176
+
3177
+ /**
3178
+ * 폴더 칸 하나에 그릴 것.
3179
+ * @public
3180
+ */
3181
+ export declare interface FolderEntry {
3182
+ /** 폴더의 **온 길**(`앙/하위`) — 여는 손 · 끌어다 놓는 손 · 메뉴가 이것을 받는다 */
3183
+ name: string;
3184
+ /** 화면에 보일 이름 — 길의 마지막 마디. 안 주면 `name` 그대로 */
3185
+ label?: string;
3186
+ /** 이 폴더에 든 수 — 찾기 · 쪽 나누기와 상관없이 **전부** */
3187
+ count: number;
3188
+ }
3189
+
3190
+ /**
3191
+ * **폴더 칸의 격자** — 폴더 하나가 단추 하나(아이콘 · 이름 · 든 수)이고, 누르면 그 안으로 들어간다(말귀 청 (435)).
3192
+ *
3193
+ * 말귀의 나의 단어훈련에서 먼저 섰다(사장님 지시 2026-11-13 *"그룹과 훈련묶음의 화면이 구조가 이해도 안되고 어떤 그룹은 하단으로
3194
+ * 내려가 있으니까 너무 불편해. 구글 드라이브 식으로"* → *"이런구조. 브래드와 폴더와 리스트."*). 그룹이 전부 펼쳐진 채 위아래로
3195
+ * 쌓이던 것을, 그룹 하나를 **작은 칸 하나**로 줄였다.
3196
+ *
3197
+ * · 칸은 `Button`(bar · 48 · default · 왼쪽 맞춤)이고 폭은 200 으로 고정이다 — 긴 이름은 단추가 줄인다.
3198
+ * · **놓을 자리이기도 하다** — 카드든 폴더든 끌고 그 위에 오면 단추가 기본 호버 꼴(`is-hover`)이 된다. 따로 테를 두르지 않는다.
3199
+ * · 폴더가 없으면 아무것도 안 그린다(빈 격자가 자리를 먹지 않는다).
3200
+ * @public
3201
+ */
3202
+ export declare function FolderGrid({ folders, onOpen, dropProps, dropOver, menuItems, onMove }: FolderGridProps): JSX.Element | null;
3203
+
3204
+ /** @public */
3205
+ export declare interface FolderGridProps {
3206
+ folders: FolderEntry[];
3207
+ onOpen: (name: string) => void;
3208
+ /** 그 칸을 **든 것(카드)이 놓일 자리**로 만드는 손 — 화면의 끌기 훅이 내주는 것(`onDragOver` · `onDrop` …)을 그대로 얹는다 */
3209
+ dropProps?: (name: string) => Record<string, unknown>;
3210
+ /** 지금 카드가 그 위에 떠 있는 폴더 */
3211
+ dropOver?: string | null;
3212
+ /**
3213
+ * 폴더 칸 오른쪽의 ⋯ 메뉴 — 주면 칸마다 ⋯ 가 서고, 누르면 그 폴더의 메뉴가 아래로 열린다(폴더는 안 열린다).
3214
+ * `FolderHead` 는 길의 「이름 ▾」 와 **같은 줄들**을 넘긴다.
3215
+ */
3216
+ menuItems?: (name: string) => TooltipMenuColumnItem[];
3217
+ /**
3218
+ * **폴더 칸을 끌어 다른 폴더 칸에 넣는다** — 주면 칸을 쥐고 끌 수 있고, 다른 폴더 칸에 놓으면 그 안으로 들어간다.
3219
+ * 제 자신에게는 안 놓인다. 폴더 밖으로 빼는 것은 구조 나무(`FolderTreeTooltip`)에서 한다(여기 선 칸들은 모두 같은 자리의
3220
+ * 폴더라 '밖' 이 없다).
3221
+ */
3222
+ onMove?: (path: string, into: string) => void;
3223
+ }
3224
+
3225
+ /**
3226
+ * **폴더로 보는 화면의 머리** — 구조 단추 · 길(브레드크럼) · 지금 자리의 폴더 칸들. 도구줄 **위**에 선다(말귀 청 (435)).
3227
+ *
3228
+ * 말귀의 나의 단어표 · 나의 단어훈련 · 나의 문장훈련이 이 꼴로 선다(사장님 지시 2026-11-13 — 구글 드라이브 식 "브래드와 폴더와
3229
+ * 리스트"). 차례는 길 · 폴더 · 도구줄 · 목록이고, 도구줄과 목록은 부르는 쪽이 그 아래에 세운다.
3230
+ *
3231
+ * · **길의 마지막 칸은 늘 메뉴 단추다**(「이름 ▾」) — 폴더 안이면 그 폴더의 메뉴(`folderMenu`), 맨 위면 맨 위의 메뉴(`rootMenu`).
3232
+ * · **폴더 칸은 지금 자리의 바로 아래 폴더들이다** — 폴더 안에도 폴더가 선다(이름을 길로 적는다 — `utils` 의 `folder*`).
3233
+ * 길은 층마다 한 칸씩 이어진다. 칸마다 ⋯ 가 서고, 그 줄은 「이름 ▾」 와 한 벌이다.
3234
+ * · 메뉴는 **아래로** 펼친다 — 위로 뜨면 쪽 제목을 덮는다.
3235
+ * · 길 줄의 키는 40 으로 고정이다(`Breadcrumb size="medium"`) — 폴더를 드나들 때 아래가 안 튄다.
3236
+ * @public
3237
+ */
3238
+ export declare function FolderHead({ rootLabel, opened, onOpen, paths, countOf, folderMenu, rootMenu, dropProps, dropOver, onMoveFolder, itemDragging, rootDropKey, }: FolderHeadProps): JSX.Element;
3239
+
3240
+ /** @public */
3241
+ export declare interface FolderHeadProps {
3242
+ /** 맨 위의 이름 — 길의 첫 칸 · 구조 나무의 첫 줄 */
3243
+ rootLabel: string;
3244
+ /** 지금 들어가 있는 폴더의 **온 길**(없으면 맨 위) */
3245
+ opened: string | null;
3246
+ onOpen: (path: string | null) => void;
3247
+ /** 있는 폴더 전부의 길 — 중간 폴더가 빠져 있어도 된다(여기서 채운다). 차례는 받은 그대로 */
3248
+ paths: readonly string[];
3249
+ /** 그 폴더에 든 수(하위 폴더에 든 것까지) */
3250
+ countOf: (path: string) => number;
3251
+ /** 그 폴더의 메뉴 줄 — 길의 「이름 ▾」 와 폴더 칸의 ⋯ 가 함께 쓴다 */
3252
+ folderMenu?: (path: string) => TooltipMenuColumnItem[];
3253
+ /** 맨 위의 메뉴 줄 */
3254
+ rootMenu?: TooltipMenuColumnItem[];
3255
+ /** 그 폴더를 **든 것(카드)이 놓일 자리**로 만드는 손 — 폴더 칸과 구조 나무의 줄이 함께 쓴다 */
3256
+ dropProps?: (path: string) => Record<string, unknown>;
3257
+ /** 지금 카드가 그 위에 떠 있는 폴더 */
3258
+ dropOver?: string | null;
3259
+ /** 폴더를 끌어 다른 폴더에 넣거나 뺀다 — 폴더 칸끼리, 그리고 구조 나무에서(`into` 가 `null` 이면 맨 위로) */
3260
+ onMoveFolder?: (path: string, into: string | null) => void;
3261
+ /** 화면이 카드를 끄는 중인가 — 그때 구조 단추 위로 오면 나무가 펼쳐지고, 나무의 줄이 놓을 자리가 된다 */
3262
+ itemDragging?: boolean;
3263
+ /** 맨 위(폴더 밖)로 놓을 때의 열쇠 — `dropProps` · `dropOver` 가 맨 위를 가리키는 그 값. 안 주면 나무의 맨 위 줄에는 못 놓는다 */
3264
+ rootDropKey?: string;
3265
+ }
3266
+
3267
+ /** @public 폴더 안에 새 폴더의 길을 짓는다 — `parent` 가 없으면 맨 위에 선다 */
3268
+ export declare const folderJoin: (parent: string | null, name: string) => string;
3269
+
3270
+ /** @public 화면에 보일 이름 — 길의 마지막 마디 */
3271
+ export declare function folderLeaf(path: string): string;
3272
+
3273
+ /** @public 폴더 메뉴의 줄을 정해진 차례 · 아이콘으로 짓는다 */
3274
+ export declare function folderMenuItems(lines: {
3275
+ /** 이 자리에 하나 더 만든다(무엇을 만드는지는 화면 몫) */
3276
+ add: FolderMenuLine;
3277
+ addFolder: FolderMenuLine;
3278
+ rename?: FolderMenuLine;
3279
+ remove?: FolderMenuLine;
3280
+ }): {
3281
+ label: string;
3282
+ icon: string;
3283
+ onClick: () => void;
3284
+ closeOnSelect: true;
3285
+ }[];
3286
+
3287
+ /**
3288
+ * **폴더 메뉴의 줄** — 길의 「이름 ▾」 와 폴더 칸의 ⋯ 가 여는 메뉴(말귀 청 (437) ㉮ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
3289
+ *
3290
+ * 화면마다 차례와 아이콘이 갈리면 안 되는 자리다: **더하기 → 폴더 추가 → (이름 바꾸기) → 폴더 삭제**. 구분선은 없고, 줄을 고르면 닫힌다.
3291
+ * 이름표는 부르는 쪽이 준다(무엇을 '더하는지' 는 화면마다 다르다 — 단어표 · 훈련 …).
3292
+ * · 맨 위의 메뉴는 `rename` · `remove` 를 안 준다(지울 폴더가 없다).
3293
+ * · 이름 바꾸기는 그 일이 있는 화면만 준다.
3294
+ * 돌려준 줄은 `FolderHead` 의 `folderMenu` · `rootMenu`, `FolderGrid` 의 `menuItems` 에 그대로 넘긴다.
3295
+ */
3296
+ /** @public 메뉴 한 줄 — 이름표와 할 일 */
3297
+ export declare interface FolderMenuLine {
3298
+ label: string;
3299
+ onClick: () => void;
3300
+ }
3301
+
3302
+ /**
3303
+ * 폴더 `from` 을 `toParent` 안으로 **옮겼을 때** `path` 의 새 길(사장님 지시 2026-11-13 "드래드 해서 다른 폴더에 넣거나 뺄 수
3304
+ * 있도록"). `path` 가 `from` 그 자체나 그 아래면 앞머리를 갈아 돌려주고, 상관없는 길이면 `undefined`.
3305
+ * `toParent` 가 `null` 이면 맨 위로 뺀다.
3306
+ * @public
3307
+ */
3308
+ export declare function folderMoved(path: string | null | undefined, from: string, toParent: string | null): string | undefined;
3309
+
3310
+ /**
3311
+ * 폴더 `from` 을 `into` 안으로 옮기려 할 때의 **판정** — 세 화면(나의 단어표 · 단어훈련 · 문장훈련)이 같은 말을 따로 적고 있었다.
3312
+ * · `noop` — 옮길 것이 없다(제 자신 · 제 아래 · 이미 그 자리)
3313
+ * · `clash` — 그 자리에 같은 이름의 폴더가 이미 있다(알린다 — `folderTree.moveClash`)
3314
+ * · `ok` — 옮긴다. 새 길은 `folderMoved(from, from, into)`
3315
+ * @public
3316
+ */
3317
+ export declare function folderMoveVerdict(from: string, into: string | null, existing: readonly string[]): 'ok' | 'clash' | 'noop';
3318
+
3319
+ /** @public 한 층 위 폴더의 길 — 맨 위 폴더면 `null`(맨 위) */
3320
+ export declare function folderParent(path: string): string | null;
3321
+
3322
+ /**
3323
+ * **찾은 것을 폴더마다 나눠 세운다** — 찾는 중의 목록(말귀 청 (437) ㉮ — 말귀 앱에서 옮겨 왔다, 2026-11-13).
3324
+ *
3325
+ * 찾는 중에는 폴더를 가리지 않고 **전부에서** 찾는다(`useFolderBrowse`). 찾은 것이 여러 폴더에 걸치므로 어느 폴더의 것인지가
3326
+ * 보여야 한다 — 폴더마다 가벼운 제목 한 줄(길 · 수)을 두고 그 아래 카드를 세운다(`CardSection`). 회색 그룹 칸은 두르지 않는다.
3327
+ * 폴더를 다루는 일(이름 고치기 · 지우기 · 끌어 놓기)은 여기 없다 — 찾는 중에 하는 일이 아니고, 폴더 메뉴에 있다.
3328
+ *
3329
+ * · **빈 폴더는 안 세운다** — 찾은 것이 없는 폴더의 제목만 줄줄이 서면 찾은 것이 묻힌다.
3330
+ * · 폴더 안의 폴더는 길(`앙/하위`)을 `앙 › 하위` 로 이어 보인다.
3331
+ * · 폴더 없는 것은 `noneLabel` 아래에 선다.
3332
+ * @public
3333
+ */
3334
+ export declare function FolderSearchSections<T>({ bundles, noneKey, noneLabel, titleLevel, rowRender }: FolderSearchSectionsProps<T>): JSX.Element;
3335
+
3336
+ /** @public */
3337
+ export declare interface FolderSearchSectionsProps<T> {
3338
+ /** 폴더마다의 찾은 것 — `[폴더의 길(없으면 noneKey), 그 줄들]`. 차례는 받은 그대로 */
3339
+ bundles: readonly (readonly [string, readonly T[]])[];
3340
+ /** 폴더 없는 것을 가리키는 열쇠 */
3341
+ noneKey: string;
3342
+ /** 폴더 없는 것의 이름 */
3343
+ noneLabel: string;
3344
+ titleLevel?: 2 | 3 | 4;
3345
+ rowRender: (row: T, slot: number) => ReactNode;
3346
+ }
3347
+
3348
+ /** @public 맨 위에서 그 폴더까지의 길 — 층마다 `{ path, label }`(길 · 보일 이름) */
3349
+ export declare function folderTrail(path: string): {
3350
+ path: string;
3351
+ label: string;
3352
+ }[];
3353
+
3354
+ /** @public 폴더 나무를 **펼친 차례**로 — 부모 바로 뒤에 그 자식들이 선다. 층은 0 부터 */
3355
+ export declare function folderTree(paths: readonly string[]): {
3356
+ path: string;
3357
+ label: string;
3358
+ depth: number;
3359
+ }[];
3360
+
3361
+ /**
3362
+ * **폴더 구조를 펼쳐 보는 단추** — 길(`Breadcrumb`) 앞에 선다(말귀 청 (435)).
3363
+ *
3364
+ * 드라이브의 왼쪽 폴더 나무를 보여 주되 자리를 늘 차지하지 않게 하려는 것이다(사장님 지시 2026-11-13 *"sidebar도 이미 있고
3365
+ * 영역을 잡고 있기가 싫은데"* → *"앞에 구조 보려줄 수 있는 버튼 넣고 누르면 tooltip 형태로 나오도록 해봐"*). **누를 때만** 뜬다:
3366
+ * 맨 위와 폴더 전부가 한 줄씩 서고, 지금 있는 자리에 표시가 붙으며, 줄을 누르면 그리로 간다. 폴더가 하나도 없어도 단추는 선다
3367
+ * (맨 위 한 줄).
3368
+ *
3369
+ * 뜨는 나무는 제 조각이다(`FolderTreeTooltip`) — 여기는 **띄우는 단추**(dot · 40 · default)와 여닫음만 쥔다.
3370
+ * @public
3371
+ */
3372
+ export declare function FolderTreeButton({ rootLabel, opened, onOpen, tree, onMove, itemDragging, itemDropProps, itemDropOver, }: FolderTreeButtonProps): JSX.Element;
3373
+
3374
+ /** @public */
3375
+ export declare interface FolderTreeButtonProps {
3376
+ /** 맨 위의 이름 — 나무의 첫 줄 */
3377
+ rootLabel: string;
3378
+ /** 지금 들어가 있는 폴더(없으면 맨 위) */
3379
+ opened: string | null;
3380
+ onOpen: (path: string | null) => void;
3381
+ /** 폴더 나무를 **펼친 차례**로(`folderTree`) — 층(`depth`)만큼 들여 세운다. `count` 는 그 폴더에 든 수 */
3382
+ tree: readonly FolderTreeNode[];
3383
+ /** 폴더를 끌어 다른 폴더에 넣거나 뺀다 — 나무(`FolderTreeTooltip`)로 그대로 간다 */
3384
+ onMove?: (path: string, into: string | null) => void;
3385
+ /**
3386
+ * 화면이 **든 것(카드)을 끄는 중**인가 — 그때 이 단추 위로 끌고 오면 나무가 절로 펼쳐지고(누를 손이 없다), 끌기가 끝나면
3387
+ * 닫힌다.
3388
+ */
3389
+ itemDragging?: boolean;
3390
+ /** 카드가 놓일 자리로 만드는 손 · 떠 있는 줄 — 나무(`FolderTreeTooltip`)로 그대로 간다 */
3391
+ itemDropProps?: (path: string | null) => Record<string, unknown>;
3392
+ itemDropOver?: (path: string | null) => boolean;
3393
+ }
3394
+
3395
+ /**
3396
+ * 나무의 한 줄 — `folderTree`(`utils`)가 내주는 꼴에 든 수를 얹은 것.
3397
+ * @public
3398
+ */
3399
+ export declare interface FolderTreeNode {
3400
+ /** 폴더의 온 길(`앙/하위`) — 고르면 이것을 돌려준다 */
3401
+ path: string;
3402
+ /** 보일 이름 — 길의 마지막 마디 */
3403
+ label: string;
3404
+ /** 층 — 맨 위 폴더가 0 */
3405
+ depth: number;
3406
+ /** 그 폴더에 든 수 — 0 이면 안 적는다 */
3407
+ count: number;
3408
+ }
3409
+
3410
+ /**
3411
+ * **폴더 구조를 나무로 띄우는 툴팁** — `MenuTooltip` 의 짝이다. 그쪽이 '할 일의 줄' 이라면 이쪽은 **'어디에 있나' 의 나무**다
3412
+ * (말귀 청 (435), 사장님 지시 2026-11-13 *"menu 툴팁 사용하지말고 폴더 구조를 보여줄 수 있는 ui로 구성되도록 새로운 tooltip
3413
+ * 만들어줘"*). 뜨는 통(그림자 · 모서리 · 자리 · 바깥 누름)은 `Tooltip` 그대로이고 속만 여기서 그린다: 줄마다 폴더 아이콘 ·
3414
+ * 이름 · 든 수 · 접는 화살표가 서고, 층은 들여쓰기와 꺾쇠(└)다. 지금 자리는 옅은 바탕 · 굵은 글자 · 열린 폴더 아이콘으로 말한다.
3415
+ *
3416
+ * · **맨 위(뿌리)가 첫 줄**이다 — `rootLabel`. 고르면 `null` 을 돌려준다.
3417
+ * · 하위 폴더가 있는 줄은 오른쪽 끝의 화살표로 **접고 편다**(처음엔 다 펴져 있다). 접힘은 이 통이 떠 있는 동안만 기억한다.
3418
+ * · 줄을 고르면 `onPick` 을 부르고 **닫는다**(`onClose`). 닫을지는 부르는 쪽이 쥔다 — 통을 띄운 단추가 제 상태를 안다.
3419
+ * · 아래로 펼친다(`prefer="bottom"`) — 위로 뜨면 쪽 제목을 덮는다.
3420
+ *
3421
+ * 띄우는 단추는 따로 있다(`FolderTreeButton`).
3422
+ * @public
3423
+ */
3424
+ export declare function FolderTreeTooltip({ anchorEl, onClose, rootLabel, opened, onPick, tree, ariaLabel, onMove, itemDropProps, itemDropOver, }: FolderTreeTooltipProps): JSX.Element;
3425
+
3426
+ /** @public */
3427
+ export declare interface FolderTreeTooltipProps {
3428
+ /** 통이 붙을 마디 — 띄운 단추 */
3429
+ anchorEl: Element | null;
3430
+ onClose: () => void;
3431
+ /** 맨 위의 이름 — 나무의 첫 줄 */
3432
+ rootLabel: string;
3433
+ /** 지금 있는 폴더의 온 길(맨 위면 `null`) — 그 줄에 표시가 붙는다 */
3434
+ opened: string | null;
3435
+ /** 줄을 골랐다 — 폴더의 온 길, 맨 위면 `null` */
3436
+ onPick: (path: string | null) => void;
3437
+ /** 나무를 **펼친 차례**로 — 부모 바로 뒤에 자식이 선다(`folderTree`) */
3438
+ tree: readonly FolderTreeNode[];
3439
+ /** 낭독기가 읽을 통의 이름 */
3440
+ ariaLabel: string;
3441
+ /**
3442
+ * 폴더를 끌어 **다른 폴더에 넣거나 뺀다** — 주면 폴더 줄을 쥐고 끌 수 있고, 다른 폴더 줄에 놓으면 그 안으로, 맨 위 줄에
3443
+ * 놓으면 맨 위로 뺀다. `into` 는 놓은 폴더의 온 길(맨 위면 `null`). 제 자신 · 제 아래 · 이미 있는 자리에는 안 놓인다
3444
+ * (`canMoveFolder`). 통은 옮긴 뒤에도 떠 있다 — 이어서 더 옮길 수 있게.
3445
+ */
3446
+ onMove?: (path: string, into: string | null) => void;
3447
+ /**
3448
+ * **든 것(카드)을 나무의 줄에 끌어다 놓는다** — 화면이 카드를 끄는 중일 때 그 줄을 놓을 자리로 만드는 손이다(폴더 칸
3449
+ * `FolderGrid` 가 쓰는 것과 같은 손). `path` 가 `null` 이면 맨 위 줄이다. 폴더 줄을 끄는 중(폴더 옮기기)에는 안 쓴다 —
3450
+ * 두 가지 끌기가 한 줄에서 겹치지 않게.
3451
+ */
3452
+ itemDropProps?: (path: string | null) => Record<string, unknown>;
3453
+ /** 끌고 있는 카드가 지금 그 줄 위에 떠 있나 */
3454
+ itemDropOver?: (path: string | null) => boolean;
3455
+ }
3456
+
3080
3457
  /**
3081
3458
  * 글자 크기(앱 전체) 유틸리티
3082
3459
  * - 'medium' | 'large1' | 'large2' | 'large3'
@@ -3888,6 +4265,12 @@ export declare function isAllChoseong(search: string): boolean;
3888
4265
  */
3889
4266
  export declare function isChunkLoadError(error: unknown): boolean;
3890
4267
 
4268
+ /** @public 새 폴더 이름으로 쓸 수 있나 — 비지 않고, 길을 가르는 글자가 없어야 한다 */
4269
+ export declare const isFolderNameOk: (name: string) => boolean;
4270
+
4271
+ /** @public `path` 가 `ancestor` 그 자체이거나 그 아래인가 */
4272
+ export declare const isInFolder: (path: string | null | undefined, ancestor: string) => boolean;
4273
+
3891
4274
  /**
3892
4275
  * @public 티어가 매니저 줄(말귀매니저)인지. `none` 과 개인 줄(free·personal_standard)은 false.
3893
4276
  *
@@ -9529,6 +9912,12 @@ export declare interface TooltipProps {
9529
9912
  anchorEl?: Element | null;
9530
9913
  offset?: number;
9531
9914
  edgeMargin?: number;
9915
+ /**
9916
+ * 먼저 고를 쪽. 기본 `top` — 전처럼 위에 자리가 있으면 위로 뜬다.
9917
+ * `bottom` 을 주면 **아래에 자리가 있을 때 아래로** 뜬다(없으면 위 · 옆으로 전과 같이 넘어간다) — 단추에서 펼쳐 내리는
9918
+ * 메뉴(「폴더 이름 ▾」)에 쓴다(말귀 청 (432), 사장님 지시 2026-11-13 "tooltip 아래로 나오도록").
9919
+ */
9920
+ prefer?: 'top' | 'bottom';
9532
9921
  onClose?: () => void;
9533
9922
  closeOnOutsideClick?: boolean;
9534
9923
  className?: string;
@@ -11102,6 +11491,9 @@ export declare interface UseCalendarMonthResult {
11102
11491
  setViewYM: (y: number, m: number) => void;
11103
11492
  }
11104
11493
 
11494
+ /** @public */
11495
+ export declare function useCardDragToGroup<T = string>(onDrop: (payload: T, groupKey: string) => void, getId?: (payload: T) => string): CardDragToGroup<T>;
11496
+
11105
11497
  /**
11106
11498
  * TextField의 `suggestions` 옵션이 쓰는 자동완성 콤보박스 상태/키보드 로직.
11107
11499
  * 순수 입력(값 관리)과 분리해서, 자동완성이 필요 없는 TextField 사용처는
@@ -11293,6 +11685,37 @@ export declare interface UseFitScaleResult {
11293
11685
  offset: number;
11294
11686
  }
11295
11687
 
11688
+ /**
11689
+ * **폴더로 보는 화면의 자리** — 지금 어느 폴더 안에 있나, 찾는 중인가, 새 폴더는 어디에 서나(말귀 청 (437) ㉮ — 말귀 앱에서 옮겨 왔다).
11690
+ *
11691
+ * 말귀의 나의 단어표 · 나의 단어훈련 · 나의 문장훈련이 이 규칙을 한 벌씩 들고 있다가 앱에서 한 벌로 모았고, 코어 `FolderHead` 식구로 옮겼다.
11692
+ * 화면마다 같아야 하는 규칙이다:
11693
+ *
11694
+ * · **목록에 없는 폴더는 안 연 것으로 친다** — 들어가 있던 폴더를 지웠거나 보기(갈래)를 바꿔 그 폴더가 없으면 맨 위로 돌아온다.
11695
+ * · **찾는 중에는 폴더를 가리지 않는다** — 그때 새 폴더는 맨 위에 선다(길이 안 보이는데 안 보이는 폴더 안에 만들면 안 된다).
11696
+ * · 폴더를 열면 **첫 쪽으로** 돌아간다(`onOpen`) — 3쪽을 보다가 폴더에 들어가면 그 폴더의 3쪽(대개 빈 화면)이 선다.
11697
+ * · 들어가 있던 폴더가 옮겨지거나 이름이 바뀌면 **그 새 길로 따라간다** — 안 따라가면 맨 위로 튕긴다.
11698
+ * @public
11699
+ */
11700
+ export declare function useFolderBrowse({ paths, search, onOpen }: {
11701
+ /** 있는 폴더 전부의 길(중간 폴더까지 채운 것 — `withAncestors`) */
11702
+ paths: readonly string[];
11703
+ /** 찾는 말 — 비어 있지 않으면 찾는 중이다 */
11704
+ search: string;
11705
+ /** 폴더를 열거나 맨 위로 갈 때 함께 할 일 — 쪽을 첫 쪽으로 돌린다 */
11706
+ onOpen?: () => void;
11707
+ }): {
11708
+ opened: string | null;
11709
+ searching: boolean;
11710
+ open: (path: string | null) => void;
11711
+ reset: () => void;
11712
+ followMove: (from: string, into: string | null) => void;
11713
+ followRename: (from: string, to: string) => void;
11714
+ newFolderParent: string | null;
11715
+ /** 새 폴더가 설 자리에 이미 있는 이름들 — 같은 이름을 또 못 짓게 견준다 */
11716
+ siblingNames: string[];
11717
+ };
11718
+
11296
11719
  /** @public */
11297
11720
  export declare function useFontScale({ storageKey, baseFont, minScale, maxScale, step, lineHeightRatio, }?: UseFontScaleOptions): {
11298
11721
  scale: number;
@@ -11987,6 +12410,13 @@ export declare function weakItems(records: readonly ScoreRecord[]): WeakItem[];
11987
12410
  /** @public */
11988
12411
  export declare const weekValueOf: (monthKey: string, week: number) => string;
11989
12412
 
12413
+ /**
12414
+ * 적힌 길들에 **중간 폴더를 채워** 돌려준다(받은 차례를 지키고, 중간 폴더는 그 하위가 처음 나온 자리 앞에 선다).
12415
+ * 같은 길은 한 번만.
12416
+ * @public
12417
+ */
12418
+ export declare function withAncestors(paths: readonly string[]): string[];
12419
+
11990
12420
  /** text 뒤에 문맥에 맞는 을/를을 붙여 반환한다. */
11991
12421
  export declare function withEulReul(text: string): string;
11992
12422
 
@@ -3,6 +3,13 @@
3
3
  align-items: center;
4
4
  }
5
5
 
6
+ /* `medium` 은 **높이 40 으로 고정**이다(사장님 지시 2026-11-13 "요소가 있거나 없어도 높이 달라지지 않게. 미디움은 높이 40으로
7
+ 고정") — 도구줄의 단추(40)와 같은 키다. 옆에 단추가 붙든 안 붙든 줄의 키가 같아, 폴더를 드나들 때 아래가 안 튄다.
8
+ `small` 은 전처럼 글자 키를 따른다. */
9
+ .breadcrumb--medium {
10
+ height: 40px;
11
+ }
12
+
6
13
  .breadcrumb__list {
7
14
  display: flex;
8
15
  align-items: center;
@@ -54,6 +61,51 @@
54
61
  color: var(--color-darkGray);
55
62
  }
56
63
 
64
+ /* `medium` 의 앞 칸은 얹어도 **파랗게 안 바뀐다**(사장님 지시 2026-11-13 "호버시 파란색 표현 제거") — 밑줄도 안 긋는다.
65
+ 누를 자리라는 것은 마지막 칸의 메뉴 단추와 **같은 옅은 바탕**으로 말한다(한 줄에서 두 가지 호버 꼴이 서지 않게).
66
+ `small` 은 전처럼 파란 글자 + 밑줄이다 — 다른 화면의 길은 안 바뀐다. */
67
+ .breadcrumb--medium .breadcrumb__link {
68
+ min-height: 32px;
69
+ margin: 0 calc(-1 * var(--spacing-xs));
70
+ padding: 0 var(--spacing-xs);
71
+ border-radius: var(--radius-s);
72
+ }
73
+ .breadcrumb--medium .breadcrumb__link:hover {
74
+ color: var(--color-gray);
75
+ text-decoration: none;
76
+ background: var(--color-darkWhite);
77
+ }
78
+
79
+ /* 메뉴를 단 마지막 항목 — 이름과 ▾ 가 한 단추다(구글 드라이브의 「폴더 이름 ▾」). 단추 기본 꼴을 걷고 글자처럼 세우되,
80
+ 누를 자리라는 것은 손 모양과 얹었을 때의 옅은 바탕으로 말한다. 좌우 여백만큼 왼쪽으로 당겨 글자 자리는 그대로 둔다. */
81
+ .breadcrumb__current--menu {
82
+ display: inline-flex;
83
+ align-items: center;
84
+ gap: var(--spacing-xs);
85
+ min-height: 32px;
86
+ margin: 0 calc(-1 * var(--spacing-xs));
87
+ padding: 0 var(--spacing-xs);
88
+ border: none;
89
+ border-radius: var(--radius-s);
90
+ background: none;
91
+ font-family: inherit;
92
+ cursor: pointer;
93
+ }
94
+ .breadcrumb__current--menu:hover,
95
+ .breadcrumb__current--menu[aria-expanded="true"] {
96
+ background: var(--color-darkWhite);
97
+ }
98
+ .breadcrumb__current--menu:focus-visible {
99
+ outline: 2px solid var(--color-main);
100
+ outline-offset: 2px;
101
+ }
102
+ .breadcrumb__menu-mark {
103
+ display: inline-flex;
104
+ align-items: center;
105
+ color: var(--color-gray);
106
+ flex-shrink: 0;
107
+ }
108
+
57
109
  /* 갈 곳이 없는 중간 항목 — 링크·단추와 같은 색이되 누를 수 있어 보이지 않게(밑줄·손 모양 없음) */
58
110
  .breadcrumb__text {
59
111
  color: var(--color-gray);
@@ -10,10 +10,28 @@ export interface BreadcrumbItem {
10
10
  target?: string;
11
11
  /** 선택. 링크의 rel. `target="_blank"` 이고 안 주면 `noopener noreferrer`. */
12
12
  rel?: string;
13
+ /**
14
+ * **마지막 항목(지금 쪽)에 메뉴를 단다** — 주면 이름과 ▾ 가 **한 단추**로 서고, 누르면 그 단추를 넘겨 부른다
15
+ * (메뉴는 부르는 쪽이 그 단추에 붙여 띄운다). 구글 드라이브의 「폴더 이름 ▾」 꼴이다
16
+ * (말귀 청 (430) 보탬, 사장님 지시 2026-11-13 "클릭 되도록"). 마지막이 아닌 항목에서는 무시한다.
17
+ */
18
+ menu?: {
19
+ onOpen: (anchor: HTMLElement) => void;
20
+ /** 메뉴가 열려 있나 — `aria-expanded` 로 말한다 */
21
+ expanded?: boolean;
22
+ /** 낭독기 이름. 안 주면 항목의 `label` */
23
+ ariaLabel?: string;
24
+ };
13
25
  }
14
26
  /** @public */
15
27
  export interface BreadcrumbProps {
16
28
  items: BreadcrumbItem[];
29
+ /**
30
+ * 글자 크기. 기본 `small` — 전부터 있던 꼴 그대로다(`body-3` · 갈림표 14).
31
+ * `medium` 은 두 단 크다(`body-1` · 갈림표 18 — 처음엔 `body-2` 였는데 사장님이 보시고 "폰트 크기가 작아 더 키워줘") — 길을 쪽의 둘째 제목처럼 도구줄 위에 세울 때 쓴다
32
+ * (말귀 청 (430), 사장님 지시 2026-11-13 "브래드 크럼에 size prop 넣고 지금건 small. 미디움으로 만들어서").
33
+ */
34
+ size?: 'small' | 'medium';
17
35
  className?: string;
18
36
  }
19
37
  /**
@@ -21,4 +39,4 @@ export interface BreadcrumbProps {
21
39
  * 앞 항목은 `href` 가 있으면 링크, `onClick` 만 있으면 단추, 둘 다 없으면 글자다.
22
40
  * @public
23
41
  */
24
- export default function Breadcrumb({ items, className }: BreadcrumbProps): import("react").JSX.Element;
42
+ export default function Breadcrumb({ items, size, className }: BreadcrumbProps): import("react").JSX.Element;