@wishket/design-system 2.2.0 → 3.0.0

package/README.md

@@ -82,6 +82,64 @@ export const Home  = () => {
 export default Home;
 ```
 
+## Navigation 컴포넌트와 라우팅 라이브러리
+
+`TextLink`, `Menu`, `GNBList.Item`은 기본적으로 `<a>` 태그로 렌더되며, `as` prop으로 라우팅 라이브러리의 Link를 주입할 수 있습니다.
+
+### Next.js와 함께 사용
+
+```tsx
+import Link from 'next/link';
+import { TextLink, Menu, GNBList } from '@wishket/design-system';
+
+<TextLink as={Link} href="/about" text="About" />
+<Menu as={Link} name="Settings" href="/settings" />
+<GNBList.Item as={Link} href="/projects">프로젝트</GNBList.Item>
+```
+
+매 호출마다 `as`를 적기 번거롭다면 컨슈머 앱에서 wrapper를 한 번만 정의해두는 패턴을 권장합니다.
+
+```tsx
+// app/components/AppTextLink.tsx
+import { ComponentProps } from 'react';
+import Link from 'next/link';
+import { TextLink } from '@wishket/design-system';
+
+export const AppTextLink = (props: ComponentProps<typeof TextLink>) => (
+  <TextLink as={Link} {...props} />
+);
+```
+
+### react-router와 함께 사용
+
+`react-router`의 `Link`는 `to` prop을 쓰므로 `href` → `to` 어댑터가 필요합니다.
+
+```tsx
+import { Link as RouterLink } from 'react-router-dom';
+
+const RouterLinkAdapter = ({
+  href,
+  ...rest
+}: { href: string } & React.ComponentProps<typeof RouterLink>) => (
+  <RouterLink to={href} {...rest} />
+);
+
+<TextLink as={RouterLinkAdapter} href="/about" text="About" />
+```
+
+### v3 마이그레이션
+
+v3.0부터 위 컴포넌트들이 더 이상 자동으로 `next/link`를 사용하지 않습니다. 컨슈머 앱에서 일괄 변환을 원한다면 패키지에 포함된 jscodeshift codemod를 사용하세요.
+
+```bash
+npx jscodeshift \
+  -t node_modules/@wishket/design-system/scripts/codemods/add-as-link.ts \
+  --extensions=tsx,ts --parser=tsx \
+  src/
+```
+
+자세한 내용은 [`scripts/codemods/README.md`](./scripts/codemods/README.md)를 참고하세요.
+
 ## Customize Theme in Config File
 
 ```typescript

package/dist/Components/Base/Layouts/Box/Box.d.ts

@@ -1,12 +1,12 @@
-import { ComponentPropsWithoutRef, ElementType, PropsWithChildren } from 'react';
-export interface BoxProps extends PropsWithChildren<ComponentPropsWithoutRef<'div'>> {
-    as?: ElementType;
-}
+import { ComponentPropsWithRef, ElementType, PropsWithChildren } from 'react';
+export type BoxProps<T extends ElementType = 'div'> = {
+    as?: T;
+} & PropsWithChildren<Omit<ComponentPropsWithRef<T>, 'as'>>;
 /**
  * @param {Object} props
  * @param {ReactNode} props.children - 박스 내부에 렌더링할 컨텐츠
  * @param {ElementType} [props.as='div'] - 렌더링할 HTML 요소
  * @param {string} [props.className] - 추가적인 CSS 클래스
  */
-declare const Box: import("react").ForwardRefExoticComponent<BoxProps & import("react").RefAttributes<HTMLDivElement>>;
+declare const Box: import("react").ForwardRefExoticComponent<Omit<BoxProps<ElementType>, "ref"> & import("react").RefAttributes<any>>;
 export { Box };

package/dist/Components/Base/Layouts/Box/Box.js

@@ -4,5 +4,6 @@ import{jsx as e}from"react/jsx-runtime";import{twMerge as r}from"tailwind-merge"
  * @param {ReactNode} props.children - 박스 내부에 렌더링할 컨텐츠
  * @param {ElementType} [props.as='div'] - 렌더링할 HTML 요소
  * @param {string} [props.className] - 추가적인 CSS 클래스
- */(e,r);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(e);for(n=0;n<c.length;n++)t=c[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(o[t]=e[t])}return o}const i=/*#__PURE__*/t(((t,i)=>{var{className:l,children:a,as:b="div"}=t,f=c(t,["className","children","as"]);/*#__PURE__*/
-return e(b,o(function(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},o=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),o.forEach((function(r){n(e,r,t[r])}))}return e}({ref:i,className:r("box-border",l)},f),{children:a}))}));i.displayName="Box";export{i as Box};
+ */(e,r);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(e);for(n=0;n<c.length;n++)t=c[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(o[t]=e[t])}return o}const i=/*#__PURE__*/t(((t,// eslint-disable-next-line @typescript-eslint/no-explicit-any
+i)=>{var{as:l,className:a,children:u}=t,b=c(t,["as","className","children"]);/*#__PURE__*/
+return e(null!=l?l:"div",o(function(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},o=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),o.forEach((function(r){n(e,r,t[r])}))}return e}({ref:i,className:r("box-border",a)},b),{children:u}))}));i.displayName="Box";export{i as Box};

package/dist/Components/Base/Typography/Typography.d.ts

@@ -1,3 +1,4 @@
+import { ElementType } from 'react';
 import { TypographyProps } from './Typography.types';
 /**
  * Typography
@@ -7,5 +8,5 @@ import { TypographyProps } from './Typography.types';
  * @param {string} [props.className] - 추가적인 CSS 클래스
  * @param {keyof JSX.IntrinsicElements} [props.as='span'] - 렌더링할 HTML 요소
  */
-declare const Typography: ({ children, variant, className, as, ...rest }: TypographyProps) => import("react/jsx-runtime").JSX.Element;
+declare const Typography: <T extends ElementType = "span">({ children, variant, className, as, ...rest }: TypographyProps<T>) => import("react/jsx-runtime").JSX.Element;
 export { Typography };

package/dist/Components/Base/Typography/Typography.js

@@ -1,4 +1,4 @@
-import{jsx as t}from"react/jsx-runtime";import{twMerge as e}from"tailwind-merge";function n(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function r(t,e){return e=null!=e?e:{},Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(e)):function(t){var e=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e.push.apply(e,n)}return e}(Object(e)).forEach((function(n){Object.defineProperty(t,n,Object.getOwnPropertyDescriptor(e,n))})),t}function o(t,e){if(null==t)return{};var n,r,o=function(t,e){if(null==t)return{};var n,r,o={},c=Object.keys(t);for(r=0;r<c.length;r++)n=c[r],e.indexOf(n)>=0||(o[n]=t[n]);return o}(t,e);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(t);for(r=0;r<c.length;r++)n=c[r],e.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(o[n]=t[n])}return o}const c=[{name:"title48",class:"typo-title48"},{name:"title32",class:"typo-title32"},{name:"title28",class:"typo-title28"},{name:"title24",class:"typo-title24"},{name:"subTitle20",class:"typo-subTitle20"},{name:"subTitle18",class:"typo-subTitle18"},{name:"contents18",class:"typo-contents18"},{name:"contents16",class:"typo-contents16"},{name:"body16",class:"typo-body16"},{name:"body14",class:"typo-body14"},{name:"body13",class:"typo-body13"},{name:"caption12",class:"typo-caption12"},{name:"caption11",class:"typo-caption11"}],a=a=>{var s,{children:l,variant:i,className:p,as:y="span"}=a,b=o(a,["children","variant","className","as"]);const u=y||"span",m=(null===(s=c.find((t=>t.name===i)))||void 0===s?void 0:s.class)||"";/*#__PURE__*/
+import{jsx as t}from"react/jsx-runtime";import{twMerge as e}from"tailwind-merge";function n(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function r(t,e){return e=null!=e?e:{},Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(e)):function(t){var e=Object.keys(t);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(t);e.push.apply(e,n)}return e}(Object(e)).forEach((function(n){Object.defineProperty(t,n,Object.getOwnPropertyDescriptor(e,n))})),t}function o(t,e){if(null==t)return{};var n,r,o=function(t,e){if(null==t)return{};var n,r,o={},c=Object.keys(t);for(r=0;r<c.length;r++)n=c[r],e.indexOf(n)>=0||(o[n]=t[n]);return o}(t,e);if(Object.getOwnPropertySymbols){var c=Object.getOwnPropertySymbols(t);for(r=0;r<c.length;r++)n=c[r],e.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(o[n]=t[n])}return o}const c=[{name:"title48",class:"typo-title48"},{name:"title32",class:"typo-title32"},{name:"title28",class:"typo-title28"},{name:"title24",class:"typo-title24"},{name:"subTitle20",class:"typo-subTitle20"},{name:"subTitle18",class:"typo-subTitle18"},{name:"contents18",class:"typo-contents18"},{name:"contents16",class:"typo-contents16"},{name:"body16",class:"typo-body16"},{name:"body14",class:"typo-body14"},{name:"body13",class:"typo-body13"},{name:"caption12",class:"typo-caption12"},{name:"caption11",class:"typo-caption11"}],a=a=>{var s,{children:l,variant:i,className:p,as:y}=a,b=o(a,["children","variant","className","as"]);const u=null!=y?y:"span",m=(null===(s=c.find((t=>t.name===i)))||void 0===s?void 0:s.class)||"";/*#__PURE__*/
 return t(u,r(function(t){for(var e=1;e<arguments.length;e++){var r=null!=arguments[e]?arguments[e]:{},o=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(r).filter((function(t){return Object.getOwnPropertyDescriptor(r,t).enumerable})))),o.forEach((function(e){n(t,e,r[e])}))}return t}({className:e("tracking-default",m,p)},b),{children:l}))};
 /**
  * Typography

package/dist/Components/Base/Typography/Typography.types.d.ts

@@ -1,4 +1,4 @@
-import { ElementType, PropsWithChildren } from 'react';
+import { ComponentPropsWithoutRef, ElementType, PropsWithChildren } from 'react';
 export declare const typographyVariants: {
     readonly title48: "title48";
     readonly title32: "title32";
@@ -15,9 +15,8 @@ export declare const typographyVariants: {
     readonly caption11: "caption11";
 };
 export type TypographyVariants = (typeof typographyVariants)[keyof typeof typographyVariants];
-export interface TypographyProps extends PropsWithChildren {
+export type TypographyProps<T extends ElementType = 'span'> = PropsWithChildren<{
     variant: TypographyVariants;
     className?: string;
-    as?: ElementType;
-    [key: string]: any;
-}
+    as?: T;
+}> & Omit<ComponentPropsWithoutRef<T>, 'as' | 'children' | 'className'>;

package/dist/Components/Inputs/Calendar/Calendar.d.ts

@@ -14,6 +14,7 @@ import { CalendarProps } from './Calendar.types';
  * @param {boolean} [props.isError] - 에러 상태 표시 여부
  * @param {string} [props.className] - 컨테이너에 머지될 클래스 (예: 부모 너비에 맞추기 위한 `w-full`)
  * @param {string} [props.triggerClassName] - 트리거(TextFieldContainer)에 머지될 클래스
+ * @param {string} [props.dropdownClassName] - dropdown popup 영역에 머지될 클래스 (예: 모바일 풀너비 `w-full`)
  * @param {string} [props.minDate] - 선택 가능한 최소 날짜 (YYYY-MM-DD). 이전 날짜 셀은 disabled 처리
  * @param {string} [props.maxDate] - 선택 가능한 최대 날짜 (YYYY-MM-DD). 이후 날짜 셀은 disabled 처리
  *
@@ -52,5 +53,5 @@ import { CalendarProps } from './Calendar.types';
  * />
  * ```
  */
-declare const Calendar: ({ defaultDate, selected, onChange, disabled, placeholder, isError, className, triggerClassName, minDate, maxDate, }: CalendarProps) => import("react/jsx-runtime").JSX.Element;
+declare const Calendar: ({ defaultDate, selected, onChange, disabled, placeholder, isError, className, triggerClassName, dropdownClassName, minDate, maxDate, }: CalendarProps) => import("react/jsx-runtime").JSX.Element;
 export { Calendar };

package/dist/Components/Inputs/Calendar/Calendar.js

@@ -1,4 +1,4 @@
-"use client";import{jsxs as e,jsx as a}from"react/jsx-runtime";import{useState as t,useEffect as r}from"react";import{twMerge as s}from"tailwind-merge";import"../../DataDisplays/Avatar/Avatar.js";import{Typography as n}from"../../Base/Typography/Typography.js";import{Box as i}from"../../Base/Layouts/Box/Box.js";import"../../Base/Layouts/FullBleed/FullBleed.js";import{SystemIcon as o}from"../../DataDisplays/SystemIcon/SystemIcon.js";import"../../DataDisplays/SystemIcon/SystemIcon.constants.js";import"../../DataDisplays/Accordion/Accordion.js";import{TextFieldContainer as l}from"../TextFieldContainer/TextFieldContainer.js";import{SelectHeader as d,WeekHeader as m,DateBox as c}from"./Calendar.parts.js";import{generateDate as p,today as y,getKoreanTimeString as g,getMonthDate as x,isSameDate as h,isDateOutOfRange as u}from"./Calendar.utils.js";
+"use client";import{jsxs as e,jsx as a}from"react/jsx-runtime";import{useState as t,useEffect as r}from"react";import{twMerge as s}from"tailwind-merge";import"../../DataDisplays/Avatar/Avatar.js";import{Typography as n}from"../../Base/Typography/Typography.js";import{Box as o}from"../../Base/Layouts/Box/Box.js";import"../../Base/Layouts/FullBleed/FullBleed.js";import{SystemIcon as i}from"../../DataDisplays/SystemIcon/SystemIcon.js";import"../../DataDisplays/SystemIcon/SystemIcon.constants.js";import"../../DataDisplays/Accordion/Accordion.js";import{TextFieldContainer as l}from"../TextFieldContainer/TextFieldContainer.js";import{SelectHeader as d,WeekHeader as m,DateBox as c}from"./Calendar.parts.js";import{generateDate as p,today as y,getKoreanTimeString as g,getMonthDate as x,isSameDate as h,isDateOutOfRange as u}from"./Calendar.utils.js";
 /**
  * 날짜를 선택할 수 있는 캘린더 컴포넌트입니다.
  *
@@ -14,6 +14,7 @@
  * @param {boolean} [props.isError] - 에러 상태 표시 여부
  * @param {string} [props.className] - 컨테이너에 머지될 클래스 (예: 부모 너비에 맞추기 위한 `w-full`)
  * @param {string} [props.triggerClassName] - 트리거(TextFieldContainer)에 머지될 클래스
+ * @param {string} [props.dropdownClassName] - dropdown popup 영역에 머지될 클래스 (예: 모바일 풀너비 `w-full`)
  * @param {string} [props.minDate] - 선택 가능한 최소 날짜 (YYYY-MM-DD). 이전 날짜 셀은 disabled 처리
  * @param {string} [props.maxDate] - 선택 가능한 최대 날짜 (YYYY-MM-DD). 이후 날짜 셀은 disabled 처리
  *
@@ -51,12 +52,12 @@
  *   placeholder="시작일"
  * />
  * ```
- */const f=({defaultDate:f,selected:w,onChange:D,disabled:b,placeholder:j,isError:C,className:N,triggerClassName:$,minDate:B,maxDate:v})=>{const[A,F]=t(!1),I=()=>{b||F((e=>!e))},S=f?p(f):y,[T,L]=t(w?p(w):S),k=w?p(w):S,{year:z,month:E,date:_}=g(k),{dateList:q}=x(T.year,T.month),G=[...Array.from({length:q[0].day},(()=>null)),...q],H=e=>{if(w&&h(e,k))return;if(u(e,B,v))return;const a=`${e.year}-${e.month}-${e.date}`;null==D||D(a),F(!1)};return r((()=>{!A&&w&&L(p(w));
+ */const f=({defaultDate:f,selected:w,onChange:D,disabled:b,placeholder:j,isError:C,className:N,triggerClassName:$,dropdownClassName:B,minDate:v,maxDate:A})=>{const[F,I]=t(!1),S=()=>{b||I((e=>!e))},T=f?p(f):y,[L,k]=t(w?p(w):T),z=w?p(w):T,{year:E,month:_,date:q}=g(z),{dateList:G}=x(L.year,L.month),H=[...Array.from({length:G[0].day},(()=>null)),...G],J=e=>{if(w&&h(e,z))return;if(u(e,v,A))return;const a=`${e.year}-${e.month}-${e.date}`;null==D||D(a),I(!1)};return r((()=>{!F&&w&&k(p(w));
 // eslint-disable-next-line react-hooks/exhaustive-deps
-}),[A]),/*#__PURE__*/e(i,{className:s("relative h-fit w-fit select-none",N),"data-testid":"design-system-calendar--container",children:[
-/*#__PURE__*/a(i,{className:"cursor-pointer",children:/*#__PURE__*/e(l,{isFocused:A,isError:C,isDisabled:b,testId:"design-system-calendar--trigger",onClick:I,className:$,children:[
-/*#__PURE__*/a(o,{name:"medium_calendar",className:b||!w?"text-w-gray-300":"text-w-gray-400"}),
-/*#__PURE__*/a(n,{variant:"body16",className:s("text-w-gray-600 min-w-[178px]",!w&&"text-w-gray-300",b&&"text-w-gray-300"),"data-testid":"design-system-calendar--selected-date",children:w?`${z} ${E} ${_}`:j})]})}),A&&/*#__PURE__*/a("div",{className:"fixed top-0 left-0 z-10 h-screen w-screen bg-transparent",onClick:I}),A&&/*#__PURE__*/e(i,{"data-testid":"design-system-calendar--content",className:"border-w-gray-200 bg-w-white shadow-graymedium absolute top-[54px] z-30 flex w-[350px] flex-col gap-4 rounded-xl border px-[15px] py-[23px]",children:[
-/*#__PURE__*/a(d,{visibleDate:T,onChange:e=>{L(e)}}),
+}),[F]),/*#__PURE__*/e(o,{className:s("relative h-fit w-fit select-none",N),"data-testid":"design-system-calendar--container",children:[
+/*#__PURE__*/a(o,{className:"cursor-pointer",children:/*#__PURE__*/e(l,{isFocused:F,isError:C,isDisabled:b,testId:"design-system-calendar--trigger",onClick:S,className:$,children:[
+/*#__PURE__*/a(i,{name:"medium_calendar",className:b||!w?"text-w-gray-300":"text-w-gray-400"}),
+/*#__PURE__*/a(n,{variant:"body16",className:s("text-w-gray-600 min-w-[178px]",!w&&"text-w-gray-300",b&&"text-w-gray-300"),"data-testid":"design-system-calendar--selected-date",children:w?`${E} ${_} ${q}`:j})]})}),F&&/*#__PURE__*/a("div",{className:"fixed top-0 left-0 z-10 h-screen w-screen bg-transparent",onClick:S}),F&&/*#__PURE__*/e(o,{"data-testid":"design-system-calendar--content",className:s("border-w-gray-200 bg-w-white shadow-graymedium absolute top-[54px] z-30 flex w-[350px] flex-col gap-4 rounded-xl border px-[15px] py-[23px]",B),children:[
+/*#__PURE__*/a(d,{visibleDate:L,onChange:e=>{k(e)}}),
 /*#__PURE__*/a(m,{}),
-/*#__PURE__*/a(i,{className:"grid w-full grid-cols-7 place-content-center place-items-center gap-1",children:G.map(((e,t)=>{const r=!(!e||!w)&&h(e,k);return e?/*#__PURE__*/a(c,{date:e,selected:r,disabled:u(e,B,v),onChange:H},`${e.year}-${e.month}-${e.date}`):/*#__PURE__*/a(c,{disabled:!0},t)}))})]})]})};export{f as Calendar};
+/*#__PURE__*/a(o,{className:"grid w-full grid-cols-7 place-content-center place-items-center gap-1",children:H.map(((e,t)=>{const r=!(!e||!w)&&h(e,z);return e?/*#__PURE__*/a(c,{date:e,selected:r,disabled:u(e,v,A),onChange:J},`${e.year}-${e.month}-${e.date}`):/*#__PURE__*/a(c,{disabled:!0},t)}))})]})]})};export{f as Calendar};

package/dist/Components/Inputs/Calendar/Calendar.parts.js

@@ -4,4 +4,4 @@ return e(l,{className:"flex h-[50px] w-full gap-4",children:[
 /*#__PURE__*/t(l,{"data-testid":"design-system-calendar--to-prev-month",className:"size-6 cursor-pointer text-gray-600",onClick:()=>{i?null==o||o({year:a.year-1,month:12,date:1}):null==o||o({year:a.year,month:a.month-1,date:1})},children:/*#__PURE__*/t(n,{name:"large_arrow_left",className:"text-gray-600"})}),
 /*#__PURE__*/e(r,{variant:"subTitle18",className:"h-fit w-full text-center leading-normal text-gray-900",children:[c," ",d]}),
 /*#__PURE__*/t(l,{"data-testid":"design-system-calendar--to-next-month",className:"size-6 cursor-pointer text-gray-600",onClick:()=>{m?null==o||o({year:a.year+1,month:1,date:1}):null==o||o({year:a.year,month:a.month+1,date:1})},children:/*#__PURE__*/t(n,{name:"large_arrow_right",className:"text-gray-600"})})]})},c=({selected:e,date:n,disabled:s=!1,onChange:o})=>{const i=1===String(null==n?void 0:n.date).length?`0${null==n?void 0:n.date}`:null==n?void 0:n.date;/*#__PURE__*/
-return t(l,{className:a("bg-w-white flex size-[42px] cursor-pointer items-center justify-center rounded-full p-2 text-center",!s&&!e&&"hover:bg-primary-10",e&&"bg-primary",s&&"cursor-default"),onClick:()=>{s||null==o||o(n)},children:/*#__PURE__*/t(r,{variant:"body16",className:a("text-w-gray-900",e&&"text-w-white",s&&"text-w-gray-300"),children:i})})};export{c as DateBox,m as SelectHeader,i as WeekHeader};
+return t(l,{className:a("bg-w-white flex aspect-square w-full max-w-[42px] cursor-pointer items-center justify-center rounded-full p-2 text-center",!s&&!e&&"hover:bg-primary-10",e&&"bg-primary",s&&"cursor-default"),onClick:()=>{s||null==o||o(n)},children:/*#__PURE__*/t(r,{variant:"body16",className:a("text-w-gray-900",e&&"text-w-white",s&&"text-w-gray-300"),children:i})})};export{c as DateBox,m as SelectHeader,i as WeekHeader};

package/dist/Components/Inputs/Calendar/Calendar.types.d.ts

@@ -7,6 +7,7 @@ export interface CalendarProps {
     isError?: boolean;
     className?: string;
     triggerClassName?: string;
+    dropdownClassName?: string;
     minDate?: string;
     maxDate?: string;
 }

package/dist/Components/Navigations/GNBList/GNBList.d.ts

@@ -51,6 +51,6 @@ declare const GNBList: {
     UserInfo: ({ imgUrl, username, email, children, onClick, }: import("./GNBList.types").UserInfoProps) => import("react/jsx-runtime").JSX.Element;
     List: ({ children }: import("react").PropsWithChildren) => import("react/jsx-runtime").JSX.Element;
     SubList: ({ children }: import("react").PropsWithChildren) => import("react/jsx-runtime").JSX.Element;
-    Item: ({ hasNew, children, className, textClassName, href, ...rest }: import("./GNBList.types").GNBListItemProps) => import("react/jsx-runtime").JSX.Element;
+    Item: ({ hasNew, children, className, textClassName, href, as: LinkComponent, ...rest }: import("./GNBList.types").GNBListItemProps) => import("react/jsx-runtime").JSX.Element;
 };
 export { GNBList };

package/dist/Components/Navigations/GNBList/GNBList.parts.d.ts

@@ -99,11 +99,12 @@ declare const SubList: ({ children }: PropsWithChildren) => import("react/jsx-ru
  *
  * @description
  * 개별 메뉴 아이템을 렌더링합니다.
- * - Next.js Link로 페이지 이동
+ * - 기본은 `<a>` 태그이며, `as` prop으로 Next.js Link 등 임의의 컴포넌트 주입 가능
  * - 키보드 포커스 및 hover 스타일 지원
  *
  * @param {Object} props
  * @param {string} props.href - 이동할 페이지 경로 (필수)
+ * @param {ElementType} [props.as='a'] - anchor로 렌더할 컴포넌트 (예: next/link)
  * @param {ReactNode} props.children - 메뉴 텍스트
  * @param {boolean} [props.hasNew=false] - New 뱃지 표시 여부
  * @param {string} [props.className] - Link에 적용할 추가 CSS 클래스
@@ -131,5 +132,5 @@ declare const SubList: ({ children }: PropsWithChildren) => import("react/jsx-ru
  *   특별 메뉴
  * </Item>
  */
-declare const Item: ({ hasNew, children, className, textClassName, href, ...rest }: GNBListItemProps) => import("react/jsx-runtime").JSX.Element;
+declare const Item: ({ hasNew, children, className, textClassName, href, as: LinkComponent, ...rest }: GNBListItemProps) => import("react/jsx-runtime").JSX.Element;
 export { Root, UserInfo, List, SubList, Item };

package/dist/Components/Navigations/GNBList/GNBList.parts.js

@@ -1,4 +1,4 @@
-import{jsx as e,jsxs as r}from"react/jsx-runtime";import{Children as a,Fragment as t}from"react";import{twMerge as l}from"tailwind-merge";import n from"next/link";import{Avatar as o}from"../../DataDisplays/Avatar/Avatar.js";import{Typography as i}from"../../Base/Typography/Typography.js";import{Box as s}from"../../Base/Layouts/Box/Box.js";import"../../Base/Layouts/FullBleed/FullBleed.js";import"../../DataDisplays/SystemIcon/SystemIcon.constants.js";import{NewBadge as c}from"../../DataDisplays/NewBadge/NewBadge.js";import{Divider as m}from"../../DataDisplays/Divider/Divider.js";import"../../DataDisplays/Accordion/Accordion.js";function p(e,r,a){return r in e?Object.defineProperty(e,r,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[r]=a,e}function f(e){for(var r=1;r<arguments.length;r++){var a=null!=arguments[r]?arguments[r]:{},t=Object.keys(a);"function"==typeof Object.getOwnPropertySymbols&&(t=t.concat(Object.getOwnPropertySymbols(a).filter((function(e){return Object.getOwnPropertyDescriptor(a,e).enumerable})))),t.forEach((function(r){p(e,r,a[r])}))}return e}function u(e,r){return r=null!=r?r:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);r.push.apply(r,a)}return r}(Object(r)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(r,a))})),e}function y(e,r){if(null==e)return{};var a,t,l=function(e,r){if(null==e)return{};var a,t,l={},n=Object.keys(e);for(t=0;t<n.length;t++)a=n[t],r.indexOf(a)>=0||(l[a]=e[a]);return l}
+import{jsx as e,jsxs as r}from"react/jsx-runtime";import{Children as a,Fragment as t}from"react";import{twMerge as l}from"tailwind-merge";import{Avatar as n}from"../../DataDisplays/Avatar/Avatar.js";import{Typography as o}from"../../Base/Typography/Typography.js";import{Box as s}from"../../Base/Layouts/Box/Box.js";import"../../Base/Layouts/FullBleed/FullBleed.js";import"../../DataDisplays/SystemIcon/SystemIcon.constants.js";import{NewBadge as i}from"../../DataDisplays/NewBadge/NewBadge.js";import{Divider as c}from"../../DataDisplays/Divider/Divider.js";import"../../DataDisplays/Accordion/Accordion.js";function m(e,r,a){return r in e?Object.defineProperty(e,r,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[r]=a,e}function p(e){for(var r=1;r<arguments.length;r++){var a=null!=arguments[r]?arguments[r]:{},t=Object.keys(a);"function"==typeof Object.getOwnPropertySymbols&&(t=t.concat(Object.getOwnPropertySymbols(a).filter((function(e){return Object.getOwnPropertyDescriptor(a,e).enumerable})))),t.forEach((function(r){m(e,r,a[r])}))}return e}function f(e,r){return r=null!=r?r:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(r)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);r.push.apply(r,a)}return r}(Object(r)).forEach((function(a){Object.defineProperty(e,a,Object.getOwnPropertyDescriptor(r,a))})),e}function u(e,r){if(null==e)return{};var a,t,l=function(e,r){if(null==e)return{};var a,t,l={},n=Object.keys(e);for(t=0;t<n.length;t++)a=n[t],r.indexOf(a)>=0||(l[a]=e[a]);return l}
 /**
  * GNB 리스트의 루트 컴포넌트
  *
@@ -31,16 +31,16 @@ import{jsx as e,jsxs as r}from"react/jsx-runtime";import{Children as a,Fragment
  *     <Item href="/logout">로그아웃</Item>
  *   </SubList>
  * </Root>
- */(e,r);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(t=0;t<n.length;t++)a=n[t],r.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(l[a]=e[a])}return l}const b=({withUserInfo:n=!1,children:o,className:i})=>{const c=a.map(o,((a,l)=>0===l?a:/*#__PURE__*/r(t,{children:[
-/*#__PURE__*/e(m,{className:"my-2"}),a]})));/*#__PURE__*/
-return e(s,{as:"nav","aria-label":"네비게이션 메뉴",className:l("absolute flex flex-col rounded-xl bg-w-white shadow-graymedium",n?"w-[280px] pb-3 pt-5":"h-auto w-[200px] overflow-hidden py-3",i),children:c})},d=({imgUrl:a,username:t,email:l,children:n,onClick:c})=>/*#__PURE__*/r(s,{role:"region","aria-label":"사용자 정보",className:"flex w-full flex-col gap-4 px-6 pb-4",children:[
+ */(e,r);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);for(t=0;t<n.length;t++)a=n[t],r.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(l[a]=e[a])}return l}const y=({withUserInfo:n=!1,children:o,className:i})=>{const m=a.map(o,((a,l)=>0===l?a:/*#__PURE__*/r(t,{children:[
+/*#__PURE__*/e(c,{className:"my-2"}),a]})));/*#__PURE__*/
+return e(s,{as:"nav","aria-label":"네비게이션 메뉴",className:l("absolute flex flex-col rounded-xl bg-w-white shadow-graymedium",n?"w-[280px] pb-3 pt-5":"h-auto w-[200px] overflow-hidden py-3",i),children:m})},b=({imgUrl:a,username:t,email:l,children:i,onClick:c})=>/*#__PURE__*/r(s,{role:"region","aria-label":"사용자 정보",className:"flex w-full flex-col gap-4 px-6 pb-4",children:[
 /*#__PURE__*/r(s,{className:"flex w-full items-center gap-4",children:[
-/*#__PURE__*/e(o,{size:"lg",isEditable:!0,imgUrl:a,onClick:c}),
+/*#__PURE__*/e(n,{size:"lg",isEditable:!0,imgUrl:a,onClick:c}),
 /*#__PURE__*/r(s,{className:"flex w-full flex-col gap-0.5",children:[
-/*#__PURE__*/e(i,{variant:"body16",className:"text-w-gray-900 font-medium",children:t}),
-/*#__PURE__*/e(i,{variant:"body14",className:"text-w-gray-600 line-clamp-2 break-all",children:l})]})]}),n&&/*#__PURE__*/e(s,{className:"flex w-full flex-col gap-2",children:n})]}),h=({children:r})=>/*#__PURE__*/e(s,{as:"ul","aria-label":"메인 메뉴",className:"text-w-gray-900 w-full",children:r}),g=({children:r})=>/*#__PURE__*/e(s,{as:"ul","aria-label":"서브 메뉴",className:"text-w-gray-600 w-full",children:r}),w=a=>{var{hasNew:t=!1,children:o,className:m,textClassName:p,href:b}=a,d=y(a,["hasNew","children","className","textClassName","href"]);/*#__PURE__*/
-return e(s,{as:"li",children:/*#__PURE__*/r(n,u(f({href:b,className:l("hover:bg-primary-10 flex w-full cursor-pointer gap-1 px-6 py-2",m)},d),{children:[
-/*#__PURE__*/e(i,{variant:"body14",className:p,children:o}),t&&/*#__PURE__*/e(c,{className:"mt-1","aria-label":"새 소식"})]}))})};
+/*#__PURE__*/e(o,{variant:"body16",className:"text-w-gray-900 font-medium",children:t}),
+/*#__PURE__*/e(o,{variant:"body14",className:"text-w-gray-600 line-clamp-2 break-all",children:l})]})]}),i&&/*#__PURE__*/e(s,{className:"flex w-full flex-col gap-2",children:i})]}),d=({children:r})=>/*#__PURE__*/e(s,{as:"ul","aria-label":"메인 메뉴",className:"text-w-gray-900 w-full",children:r}),h=({children:r})=>/*#__PURE__*/e(s,{as:"ul","aria-label":"서브 메뉴",className:"text-w-gray-600 w-full",children:r}),g=a=>{var{hasNew:t=!1,children:n,className:c,textClassName:m,href:y,as:b="a"}=a,d=u(a,["hasNew","children","className","textClassName","href","as"]);/*#__PURE__*/
+return e(s,{as:"li",children:/*#__PURE__*/r(b,f(p({href:y,className:l("hover:bg-primary-10 flex w-full cursor-pointer gap-1 px-6 py-2",c)},d),{children:[
+/*#__PURE__*/e(o,{variant:"body14",className:m,children:n}),t&&/*#__PURE__*/e(i,{className:"mt-1","aria-label":"새 소식"})]}))})};
 /**
  * 사용자 정보 컴포넌트
  *
@@ -64,4 +64,4 @@ return e(s,{as:"li",children:/*#__PURE__*/r(n,u(f({href:b,className:l("hover:bg-
  *   <Button size="sm">프로필 수정</Button>
  *   <Button size="sm" variant="outlined">내 프로젝트</Button>
  * </UserInfo>
- */export{w as Item,h as List,b as Root,g as SubList,d as UserInfo};
+ */export{g as Item,d as List,y as Root,h as SubList,b as UserInfo};

package/dist/Components/Navigations/GNBList/GNBList.types.d.ts

@@ -1,5 +1,4 @@
-import Link from 'next/link';
-import { ComponentPropsWithoutRef, PropsWithChildren } from 'react';
+import { ComponentPropsWithoutRef, ElementType, PropsWithChildren } from 'react';
 export interface GNBListRootProps extends PropsWithChildren {
     withUserInfo?: boolean;
     className?: string;
@@ -10,7 +9,13 @@ export interface UserInfoProps extends PropsWithChildren {
     email?: string;
     onClick?: () => void;
 }
-export interface GNBListItemProps extends ComponentPropsWithoutRef<typeof Link> {
+export interface GNBListItemProps extends Omit<ComponentPropsWithoutRef<'a'>, 'href'> {
+    href: string;
     hasNew?: boolean;
     textClassName?: string;
+    /**
+     * Item에서 anchor로 렌더할 컴포넌트. 기본값은 일반 `<a>` 태그이며,
+     * Next.js의 Link 등을 주입할 수 있습니다.
+     */
+    as?: ElementType;
 }

package/dist/Components/Navigations/Menu/Menu.types.d.ts

@@ -0,0 +1,53 @@
+import { ComponentPropsWithoutRef, ElementType, ReactNode } from 'react';
+import { MediumSystemIconName, SmallSystemIconName } from '../../DataDisplays/SystemIcon';
+import { IconButtonDropdownItem } from '../../Inputs';
+/**
+ * `MenuLink`와 `MenuButton`이 공유하는 presentation props.
+ *
+ * - 시맨틱 분기(`href` vs `onClick`)는 각 컴포넌트의 별도 타입으로 표현되며,
+ *   이 타입에는 포함되지 않습니다.
+ */
+export interface MenuCommonProps {
+    type?: 'main' | 'sub';
+    variant?: 'white' | 'gray';
+    name: string;
+    badgeCount?: string;
+    isSelected?: boolean;
+    leadingIcon?: MediumSystemIconName;
+    iconButtonName?: SmallSystemIconName;
+    onOptionClick?: () => void;
+    children?: ReactNode;
+    items?: IconButtonDropdownItem[];
+    selectedItem?: IconButtonDropdownItem;
+    onItemClick?: (item: IconButtonDropdownItem) => void;
+}
+/**
+ * `MenuLink`의 props.
+ *
+ * - `href`가 필수이며, 기본 anchor(`<a>`) 또는 `as`로 주입된 컴포넌트로 렌더링됩니다.
+ * - anchor 관련 native 속성(`target`, `rel`, `download` 등)을 그대로 받습니다.
+ */
+export type MenuLinkProps = MenuCommonProps & Omit<ComponentPropsWithoutRef<'a'>, 'href' | 'className' | 'children' | 'as'> & {
+    href: string;
+    /**
+     * anchor 자리에 렌더할 컴포넌트. 기본값은 일반 `<a>` 태그이며,
+     * Next.js의 Link 등을 주입할 수 있습니다.
+     */
+    as?: ElementType;
+};
+/**
+ * `MenuButton`의 props.
+ *
+ * - `onClick`이 필수이며, 항상 `<button>`으로 렌더링됩니다.
+ * - button 관련 native 속성(`disabled`, `type` 등)을 그대로 받습니다.
+ */
+export type MenuButtonProps = MenuCommonProps & Omit<ComponentPropsWithoutRef<'button'>, 'onClick' | 'className' | 'children' | 'type'> & {
+    onClick: () => void;
+    /**
+     * HTML `<button>`의 native `type` 속성. `MenuCommonProps.type`(`'main' | 'sub'`)과
+     * 이름이 충돌하므로 별도 prop으로 전달하려면 `htmlType`을 사용하세요.
+     *
+     * 디자인 시스템의 메뉴 타입(`'main' | 'sub'`)은 `MenuCommonProps`의 `type`을 그대로 사용합니다.
+     */
+    htmlType?: 'button' | 'submit' | 'reset';
+};

package/dist/Components/Navigations/Menu/MenuBase.d.ts

@@ -0,0 +1,21 @@
+import { ElementType, ReactNode } from 'react';
+import { MenuCommonProps } from './Menu.types';
+interface MenuBaseProps extends MenuCommonProps {
+    /**
+     * 자식 wrapper로 사용할 element 또는 컴포넌트.
+     * `MenuLink`에서는 `'a'` 또는 주입된 컴포넌트, `MenuButton`에서는 `'button'`이 들어옵니다.
+     */
+    as: ElementType;
+    /**
+     * `as` 컴포넌트에 그대로 전달되는 native props (href, onClick, target 등).
+     */
+    wrapperProps?: Record<string, unknown>;
+}
+/**
+ * `MenuLink`와 `MenuButton`이 공유하는 내부 컴포넌트.
+ * presentation 로직(className 계산, leadingIcon, name, badge, trailing IconButton/Dropdown)을 담당합니다.
+ *
+ * 외부에 export 되지 않으며, `MenuLink` / `MenuButton`을 통해서만 사용됩니다.
+ */
+declare const MenuBase: ({ type, variant, name, isSelected, badgeCount, leadingIcon, iconButtonName, onOptionClick, items, selectedItem, onItemClick, as: Component, wrapperProps, }: MenuBaseProps) => ReactNode;
+export { MenuBase };

package/dist/Components/Navigations/Menu/MenuBase.js

@@ -0,0 +1,3 @@
+import{jsxs as t,jsx as e}from"react/jsx-runtime";import{twJoin as r,twMerge as o}from"tailwind-merge";import"../../DataDisplays/Avatar/Avatar.js";import{CountBadge as n}from"../../DataDisplays/CountBadge/CountBadge.js";import{Typography as s}from"../../Base/Typography/Typography.js";import"../../Base/Layouts/Box/Box.js";import"../../Base/Layouts/FullBleed/FullBleed.js";import"react";import{SystemIcon as i}from"../../DataDisplays/SystemIcon/SystemIcon.js";import"../../DataDisplays/SystemIcon/SystemIcon.constants.js";import"../../DataDisplays/Accordion/Accordion.js";import"@wishket/yogokit";import"../../Inputs/AutoCompleteList/AutoCompleteList.parts.js";import"../../Inputs/Input/Input.js";import"../../Inputs/Input/PasswordInput.js";import"../../Inputs/Input/LabelInput.js";import"../../Inputs/Input/InputTypeSelector.js";import"../../Inputs/Button/Button.js";import"../../Inputs/Calendar/Calendar.utils.js";import"../../Inputs/Checkbox/Checkbox.js";import"../../Inputs/ChoiceChip/ChoiceChip.js";import{IconButton as p}from"../../Inputs/IconButton/IconButton.js";import"../../Inputs/Radio/Radio.js";import"../../Inputs/TextField/TextField.js";import"../../Inputs/CommentArea/CommentArea.js";import{IconButtonDropdown as a}from"../../Inputs/IconButtonDropdown/IconButtonDropdown.js";import"../../Inputs/FilterChip/FilterChip.js";function m(t,e,r){return e in t?Object.defineProperty(t,e,{value:r,enumerable:!0,configurable:!0,writable:!0}):t[e]=r,t}function c(t,e){return e=null!=e?e:{},Object.getOwnPropertyDescriptors?Object.defineProperties(t,Object.getOwnPropertyDescriptors(e)):function(t){var e=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e.push.apply(e,r)}return e}(Object(e)).forEach((function(r){Object.defineProperty(t,r,Object.getOwnPropertyDescriptor(e,r))})),t}const u=(t,e,n)=>{const s="sub"===t?"pl-12":"",i={white:r("hover:bg-w-gray-50",n&&"bg-primary-10 text-primary hover:bg-primary-10"),gray:r("hover:bg-w-gray-100",n&&"bg-w-gray-100  hover:bg-w-gray-100")};return o("flex w-full cursor-pointer items-center gap-2 rounded-xl px-4 py-3 text-w-gray-900 text-left",s,i[e])},l=(t,e)=>"white"!==t?"white_gray":e?"primary":"gray",y=({type:o="main",variant:y="white",name:d,isSelected:g=!1,badgeCount:j,leadingIcon:I,iconButtonName:b,onOptionClick:f,items:h,selectedItem:w,onItemClick:O,as:C,wrapperProps:x})=>{const B=!!(b&&h&&O&&w),D=!!b&&!!f;/*#__PURE__*/
+return t(C,c(function(t){for(var e=1;e<arguments.length;e++){var r=null!=arguments[e]?arguments[e]:{},o=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(r).filter((function(t){return Object.getOwnPropertyDescriptor(r,t).enumerable})))),o.forEach((function(e){m(t,e,r[e])}))}return t}({"data-testid":"design-system-menu",className:u(o,y,g)},x),{children:[I&&/*#__PURE__*/e(i,{testId:"design-system-menu-leading-icon",name:I,className:r("white"===y&&g&&"text-primary")}),
+/*#__PURE__*/e(s,{"data-testid":"design-system-menu-name",variant:"body16",className:"w-full select-none",children:d}),j&&/*#__PURE__*/e(n,{variant:l(y,g),text:j,className:"relative",showZero:!0}),B&&/*#__PURE__*/e(a,{size:"sm",icon:b,items:h,selectedItem:w,onItemClick:O}),D&&/*#__PURE__*/e(p,{size:"sm",className:"shrink-0",onClick:t=>{t.stopPropagation(),f()},children:/*#__PURE__*/e(i,{name:b})})]}))};export{y as MenuBase};

package/dist/Components/Navigations/Menu/MenuButton.d.ts

@@ -0,0 +1,40 @@
+import { MenuButtonProps } from './Menu.types';
+/**
+ * 네비게이션에서 사용되는 버튼형 메뉴 항목.
+ *
+ * @description
+ * - 항상 `<button>`으로 렌더링됩니다.
+ * - `onClick`이 반드시 필요합니다. 페이지 이동을 위한 anchor가 필요한 경우 `MenuLink`를 사용하세요.
+ *
+ * @param {Object} props
+ * @param {() => void} props.onClick - 메뉴 클릭 시 실행될 함수 (필수)
+ * @param {'main' | 'sub'} [props.type='main'] - 메뉴 타입 (HTML `<button>`의 native `type`과는 무관. native `type`을 지정하려면 `htmlType` prop 사용)
+ * @param {'button' | 'submit' | 'reset'} [props.htmlType] - `<button>`의 native `type` 속성
+ * @param {'white' | 'gray'} [props.variant='white'] - 메뉴 스타일 변형
+ * @param {string} props.name - 메뉴에 표시될 텍스트
+ * @param {string} [props.badgeCount] - 메뉴 항목에 표시될 뱃지 숫자
+ * @param {boolean} [props.isSelected=false] - 메뉴 선택 상태
+ * @param {SystemIconName} [props.leadingIcon] - 메뉴 앞쪽에 표시될 아이콘 (medium 사이즈)
+ * @param {SystemIconName} [props.iconButtonName] - IconButtonDropdown / IconButton 아이콘 (small 사이즈)
+ * @param {() => void} [props.onOptionClick] - 후행 아이콘 클릭 시 실행될 함수 (IconButton 옵션)
+ * @param {Item[]} [props.items] - IconButtonDropdown 사용 시 필요
+ * @param {Item} [props.selectedItem] - IconButtonDropdown 사용 시 필요
+ * @param {(item: Item) => void} [props.onItemClick] - IconButtonDropdown 사용 시 필요
+ *
+ * @example
+ * // 기본 사용
+ * <MenuButton name="설정" onClick={() => openModal()} />
+ *
+ * @example
+ * // IconButtonDropdown과 함께
+ * <MenuButton
+ *   name="옵션"
+ *   onClick={() => {}}
+ *   iconButtonName="small_more_options"
+ *   items={items}
+ *   selectedItem={selectedItem}
+ *   onItemClick={onItemClick}
+ * />
+ */
+declare const MenuButton: ({ type, variant, name, badgeCount, isSelected, leadingIcon, iconButtonName, onOptionClick, items, selectedItem, onItemClick, onClick, htmlType, children: _children, ...rest }: MenuButtonProps) => import("react/jsx-runtime").JSX.Element;
+export { MenuButton };

package/dist/Components/Navigations/Menu/MenuButton.js

@@ -0,0 +1,39 @@
+import{jsx as e}from"react/jsx-runtime";import{MenuBase as t}from"./MenuBase.js";function n(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},o=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(r).filter((function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})))),o.forEach((function(t){n(e,t,r[t])}))}return e}function o(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}
+/**
+ * 네비게이션에서 사용되는 버튼형 메뉴 항목.
+ *
+ * @description
+ * - 항상 `<button>`으로 렌더링됩니다.
+ * - `onClick`이 반드시 필요합니다. 페이지 이동을 위한 anchor가 필요한 경우 `MenuLink`를 사용하세요.
+ *
+ * @param {Object} props
+ * @param {() => void} props.onClick - 메뉴 클릭 시 실행될 함수 (필수)
+ * @param {'main' | 'sub'} [props.type='main'] - 메뉴 타입 (HTML `<button>`의 native `type`과는 무관. native `type`을 지정하려면 `htmlType` prop 사용)
+ * @param {'button' | 'submit' | 'reset'} [props.htmlType] - `<button>`의 native `type` 속성
+ * @param {'white' | 'gray'} [props.variant='white'] - 메뉴 스타일 변형
+ * @param {string} props.name - 메뉴에 표시될 텍스트
+ * @param {string} [props.badgeCount] - 메뉴 항목에 표시될 뱃지 숫자
+ * @param {boolean} [props.isSelected=false] - 메뉴 선택 상태
+ * @param {SystemIconName} [props.leadingIcon] - 메뉴 앞쪽에 표시될 아이콘 (medium 사이즈)
+ * @param {SystemIconName} [props.iconButtonName] - IconButtonDropdown / IconButton 아이콘 (small 사이즈)
+ * @param {() => void} [props.onOptionClick] - 후행 아이콘 클릭 시 실행될 함수 (IconButton 옵션)
+ * @param {Item[]} [props.items] - IconButtonDropdown 사용 시 필요
+ * @param {Item} [props.selectedItem] - IconButtonDropdown 사용 시 필요
+ * @param {(item: Item) => void} [props.onItemClick] - IconButtonDropdown 사용 시 필요
+ *
+ * @example
+ * // 기본 사용
+ * <MenuButton name="설정" onClick={() => openModal()} />
+ *
+ * @example
+ * // IconButtonDropdown과 함께
+ * <MenuButton
+ *   name="옵션"
+ *   onClick={() => {}}
+ *   iconButtonName="small_more_options"
+ *   items={items}
+ *   selectedItem={selectedItem}
+ *   onItemClick={onItemClick}
+ * />
+ */(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}const i=n=>{var{type:i,variant:c,name:l,badgeCount:a,isSelected:u,leadingIcon:m,iconButtonName:p,onOptionClick:s,items:b,selectedItem:f,onItemClick:y,onClick:O,htmlType:d,children:g}=n,C=o(n,["type","variant","name","badgeCount","isSelected","leadingIcon","iconButtonName","onOptionClick","items","selectedItem","onItemClick","onClick","htmlType","children"]);/*#__PURE__*/
+return e(t,{type:i,variant:c,name:l,badgeCount:a,isSelected:u,leadingIcon:m,iconButtonName:p,onOptionClick:s,items:b,selectedItem:f,onItemClick:y,as:"button",wrapperProps:r({onClick:O,type:d},C)})};export{i as MenuButton};

package/dist/Components/Navigations/Menu/MenuLink.d.ts

@@ -0,0 +1,43 @@
+import { MenuLinkProps } from './Menu.types';
+/**
+ * 네비게이션에서 사용되는 링크형 메뉴 항목.
+ *
+ * @description
+ * - 기본은 `<a>` 태그이며, `as` prop으로 Next.js의 Link 등 임의의 컴포넌트를 주입할 수 있습니다.
+ * - `href`가 반드시 필요합니다. 클릭 핸들러만 필요한 경우 `MenuButton`을 사용하세요.
+ *
+ * @param {Object} props
+ * @param {string} props.href - 메뉴 링크 주소 (필수)
+ * @param {ElementType} [props.as='a'] - anchor 자리에 렌더할 컴포넌트 (예: next/link)
+ * @param {'main' | 'sub'} [props.type='main'] - 메뉴 타입
+ * @param {'white' | 'gray'} [props.variant='white'] - 메뉴 스타일 변형
+ * @param {string} props.name - 메뉴에 표시될 텍스트
+ * @param {string} [props.badgeCount] - 메뉴 항목에 표시될 뱃지 숫자
+ * @param {boolean} [props.isSelected=false] - 메뉴 선택 상태
+ * @param {SystemIconName} [props.leadingIcon] - 메뉴 앞쪽에 표시될 아이콘 (medium 사이즈)
+ * @param {SystemIconName} [props.iconButtonName] - IconButtonDropdown / IconButton 아이콘 (small 사이즈)
+ * @param {() => void} [props.onOptionClick] - 후행 아이콘 클릭 시 실행될 함수 (IconButton 옵션)
+ * @param {Item[]} [props.items] - IconButtonDropdown 사용 시 필요
+ * @param {Item} [props.selectedItem] - IconButtonDropdown 사용 시 필요
+ * @param {(item: Item) => void} [props.onItemClick] - IconButtonDropdown 사용 시 필요
+ *
+ * @example
+ * // 기본 사용 (일반 <a>)
+ * <MenuLink href="/projects" name="프로젝트" />
+ *
+ * @example
+ * // Next.js Link 주입
+ * import Link from 'next/link';
+ * <MenuLink as={Link} href="/projects" name="프로젝트" />
+ *
+ * @example
+ * // 외부 링크
+ * <MenuLink
+ *   href="https://example.com"
+ *   name="외부 사이트"
+ *   target="_blank"
+ *   rel="noopener noreferrer"
+ * />
+ */
+declare const MenuLink: ({ type, variant, name, badgeCount, isSelected, leadingIcon, iconButtonName, onOptionClick, items, selectedItem, onItemClick, href, as: LinkComponent, children: _children, ...rest }: MenuLinkProps) => import("react/jsx-runtime").JSX.Element;
+export { MenuLink };

package/dist/Components/Navigations/Menu/MenuLink.js

@@ -0,0 +1,42 @@
+import{jsx as e}from"react/jsx-runtime";import{MenuBase as t}from"./MenuBase.js";function n(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},o=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(r).filter((function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})))),o.forEach((function(t){n(e,t,r[t])}))}return e}function o(e,t){if(null==e)return{};var n,r,o=function(e,t){if(null==e)return{};var n,r,o={},i=Object.keys(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||(o[n]=e[n]);return o}
+/**
+ * 네비게이션에서 사용되는 링크형 메뉴 항목.
+ *
+ * @description
+ * - 기본은 `<a>` 태그이며, `as` prop으로 Next.js의 Link 등 임의의 컴포넌트를 주입할 수 있습니다.
+ * - `href`가 반드시 필요합니다. 클릭 핸들러만 필요한 경우 `MenuButton`을 사용하세요.
+ *
+ * @param {Object} props
+ * @param {string} props.href - 메뉴 링크 주소 (필수)
+ * @param {ElementType} [props.as='a'] - anchor 자리에 렌더할 컴포넌트 (예: next/link)
+ * @param {'main' | 'sub'} [props.type='main'] - 메뉴 타입
+ * @param {'white' | 'gray'} [props.variant='white'] - 메뉴 스타일 변형
+ * @param {string} props.name - 메뉴에 표시될 텍스트
+ * @param {string} [props.badgeCount] - 메뉴 항목에 표시될 뱃지 숫자
+ * @param {boolean} [props.isSelected=false] - 메뉴 선택 상태
+ * @param {SystemIconName} [props.leadingIcon] - 메뉴 앞쪽에 표시될 아이콘 (medium 사이즈)
+ * @param {SystemIconName} [props.iconButtonName] - IconButtonDropdown / IconButton 아이콘 (small 사이즈)
+ * @param {() => void} [props.onOptionClick] - 후행 아이콘 클릭 시 실행될 함수 (IconButton 옵션)
+ * @param {Item[]} [props.items] - IconButtonDropdown 사용 시 필요
+ * @param {Item} [props.selectedItem] - IconButtonDropdown 사용 시 필요
+ * @param {(item: Item) => void} [props.onItemClick] - IconButtonDropdown 사용 시 필요
+ *
+ * @example
+ * // 기본 사용 (일반 <a>)
+ * <MenuLink href="/projects" name="프로젝트" />
+ *
+ * @example
+ * // Next.js Link 주입
+ * import Link from 'next/link';
+ * <MenuLink as={Link} href="/projects" name="프로젝트" />
+ *
+ * @example
+ * // 외부 링크
+ * <MenuLink
+ *   href="https://example.com"
+ *   name="외부 사이트"
+ *   target="_blank"
+ *   rel="noopener noreferrer"
+ * />
+ */(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r<i.length;r++)n=i[r],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}const i=n=>{var{type:i,variant:c,name:a,badgeCount:l,isSelected:u,leadingIcon:m,iconButtonName:f,onOptionClick:s,items:p,selectedItem:b,onItemClick:O,href:y,as:d="a",children:g}=n,j=o(n,["type","variant","name","badgeCount","isSelected","leadingIcon","iconButtonName","onOptionClick","items","selectedItem","onItemClick","href","as","children"]);/*#__PURE__*/
+return e(t,{type:i,variant:c,name:a,badgeCount:l,isSelected:u,leadingIcon:m,iconButtonName:f,onOptionClick:s,items:p,selectedItem:b,onItemClick:O,as:d,wrapperProps:r({href:y},j)})};export{i as MenuLink};

package/dist/Components/Navigations/Menu/index.d.ts

@@ -1 +1,3 @@
-export * from './Menu';
+export * from './MenuLink';
+export * from './MenuButton';
+export type { MenuLinkProps, MenuButtonProps } from './Menu.types';