@yeongseoksong/framework 1.4.0 → 1.5.0

package/README.md

@@ -170,11 +170,12 @@ import { SdTextBody } from '@yeongseoksong/framework/ui'
 | `SdSolutionCard` | `SdSolutionCardItem` `SdSolutionCardGrid`                                                                                                                                     |
 | `SdClients`      | `SdClientsGrid` `SdClientsMarquee`                                                                                                                                            |
 | `SdMap`          | `SdMapSingle` `SdMapTabs`                                                                                                                                                     |
+| `SdBreadcrumb`   | `SdBreadcrumb` (변형 없는 단일 컴포넌트 — 이름 자체가 flat export)                                                                                                            |
 | `SdErrorView`    | `SdErrorViewPage` `SdErrorViewNotFound`                                                                                                                                       |
 | `SdLoginView`    | `SdLoginViewCard` `SdLoginViewSplit`                                                                                                                                          |
 | `SdResult`       | `SdResultSuccess` `SdResultError`                                                                                                                                             |
 | `SdToast`        | `SdToastSuccess` `SdToastError` `SdToastWarning` `SdToastInfo` `SdToastLoading` `SdToastUpdate` `SdToastHide` `SdToastClean`                                                                                                                                       |
-| `SdHeader`       | `SdHeaderMega` `SdHeaderSimple` (`SdHeader` 자체는 `Mega`와 동일)                                                                                                             |
+| `SdHeader`       | `SdHeaderMega` `SdHeaderSimple` `SdHeaderPanel` (`SdHeader` 자체는 `Mega`와 동일)                                                                                             |
 
 **클라이언트 컴포넌트에서는 네임스페이스 형태(`SdText.Body`)를 그대로 써도 됩니다.** `SdModal`은 `opened`/`onClose` 상태가 필요해 애초에 클라이언트 전용이므로 flat export가 없습니다.
 
@@ -435,6 +436,38 @@ const clients: ClientItem[] = [
 <SdClients.Marquee items={clients} speed={40} />
 ```
 
+### SdBreadcrumb
+
+`SdHeader`와 **같은 `navItems`**를 넘기면, `parentId` 트리에서 현재 경로가 놓인 위치를 찾아
+`홈 아이콘 > 조상 > … > 현재 페이지` 순의 브레드크럼을 그립니다. 마지막 크럼(현재 페이지)은
+링크가 아닌 강조 텍스트로 렌더됩니다.
+
+```tsx
+import { SdBreadcrumb } from '@yeongseoksong/framework/ui'
+
+// currentHref를 생략하면 usePathname()으로 현재 경로를 자동 추론합니다.
+// 예: /about/company/history → 홈 > 소개 > 회사소개 > 연혁
+<SdBreadcrumb navItems={navItems} />
+
+// 명시적으로 경로를 줄 수도 있습니다(상세 페이지 등 정적으로 알고 있을 때).
+<SdBreadcrumb navItems={navItems} currentHref="/about/company/history" />
+```
+
+- **자동 추론** — `currentHref`가 없으면 `next/navigation`의 `usePathname()`을 씁니다. Next.js 앱
+  라우터 컨텍스트 안에서 렌더해야 합니다.
+- **접두 매칭** — 정확히 일치하는 `href`가 없으면, 현재 경로의 상위 경로인 `href` 중 가장 구체적인
+  것을 현재로 삼습니다. 목록(`/blog`) 아래 상세(`/blog/123`) 페이지에서 목록까지의 트레일이 잡힙니다.
+- **홈 크럼** — 기본 `/`로 링크됩니다. `homeHref`/`homeLabel`로 바꿀 수 있습니다.
+
+> **`PageLayout`에 기본 내장** — `PageLayout`(Image/Minimal/Brand/Plain)에 `navItems`를 넘기면
+> 본문 최상단에 이 브레드크럼이 **자동으로** 붙습니다. `breadcrumb={false}`로 끄고, `currentHref`로
+> 경로를 강제할 수 있습니다.
+>
+> ```tsx
+> <PageLayout.Minimal navItems={navItems} title="제조">…</PageLayout.Minimal>       // 브레드크럼 자동
+> <PageLayout.Minimal navItems={navItems} breadcrumb={false} title="제조">…</PageLayout.Minimal> // 끄기
+> ```
+
 ### SdHeader / SdFooter
 
 ```tsx
@@ -491,6 +524,15 @@ const policyLinks: NavItem[] = [
 <SdHeader.Simple navItems={navItems} loginFlag />
 ```
 
+바 높이는 `Simple`처럼 60px로 고정하되 드롭다운 내부는 `Mega`와 같은 그룹 컬럼으로 펼치고 싶다면
+`SdHeader.Panel`(서버 컴포넌트에서는 `SdHeaderPanel`)을 씁니다. 상위 항목마다 붙는 개별 `Menu`는 그대로지만,
+드롭다운 안을 `Menu.Item`/`Menu.Sub` 플라이아웃 대신 자식 링크 + 손자를 자식 아래 하위 링크로 얹은
+세로 패널로 채웁니다. 모바일 드로어는 다른 변형과 동일합니다.
+
+```tsx
+<SdHeader.Panel navItems={navItems} loginFlag />
+```
+
 `navItems`는 같은 `parentId` 구조로 푸터 링크 컬럼도 만들고, 구분선 아래 하단 바에 카피라이트 · `policyLinks` · `company.socials` 아이콘이 놓입니다.
 `socials.platform`은 `x | youtube | instagram | facebook | linkedin | github | blog`를 지원합니다.
 
@@ -734,7 +776,7 @@ export default function Page() {
 }
 ```
 
-`headerVariant`로 어떤 헤더를 쓸지 고릅니다 — `mega`(기본, hover 시 확장되는 메가 메뉴) 또는 `simple`(바 높이 고정 + 항목별 드롭다운).
+`headerVariant`로 어떤 헤더를 쓸지 고릅니다 — `mega`(기본, hover 시 확장되는 메가 메뉴), `simple`(바 높이 고정 + 항목별 드롭다운), `panel`(바 높이 고정 + 드롭다운 내부를 Mega식 그룹 컬럼으로).
 
 ```tsx
 <MainLayout navItems={navItems} companyInfo={company} headerVariant="simple" loginFlag>