@wishket/design-system 2.2.1 → 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/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';

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

@@ -1,66 +1,44 @@
-import Link from 'next/link';
-import { ComponentProps } from 'react';
+import { ComponentPropsWithoutRef, ElementType } from 'react';
 import { TextWithIconsProps } from '../../Base/TextWithIcons/TextWithIcons';
-interface TextLinkProps extends ComponentProps<typeof Link>, TextWithIconsProps {
+interface TextLinkProps extends Omit<ComponentPropsWithoutRef<'a'>, 'href'>, TextWithIconsProps {
+    href: string;
+    as?: ElementType;
 }
 /**
  * 텍스트 기반의 링크 컴포넌트입니다.
  *
  * @description
- * TextButton과 동일한 스타일을 가지지만 `<a>` 태그 기반으로 페이지 네비게이션을 담당합니다.
- * Next.js의 Link 컴포넌트를 기반으로 하여 클라이언트 사이드 라우팅을 지원합니다.
+ * TextButton과 동일한 스타일을 가지지만 기본적으로 `<a>` 태그 기반으로 페이지 네비게이션을 담당합니다.
+ * `as` prop으로 Next.js의 `Link`나 React Router의 `Link` 등 임의의 컴포넌트를 주입할 수 있습니다.
  *
  * @component
  * @param {Object} props - TextLink 컴포넌트의 props
  * @param {string} props.href - 링크 대상 URL (필수)
  * @param {string} props.text - 표시할 텍스트 (필수)
+ * @param {ElementType} [props.as='a'] - 렌더링할 요소/컴포넌트
  * @param {SystemIconName} [props.leadingIcon] - 텍스트 앞에 표시할 아이콘
  * @param {SystemIconName} [props.trailingIcon] - 텍스트 뒤에 표시할 아이콘
  * @param {boolean} [props.isTextSmall=false] - 작은 텍스트 크기 사용 여부
  * @param {boolean} [props.isGray=false] - 텍스트 색상을 회색으로 사용 여부
  * @param {boolean} [props.isUnderline=false] - 텍스트에 밑줄 스타일 적용 여부
- * @param {ComponentProps<typeof Link>} props - Next.js Link 컴포넌트의 모든 props 지원
  *
  * @example
- * // 기본 사용법
+ * // 기본 사용법 (일반 <a>)
  * <TextLink href="/about" text="소개 페이지로 이동" />
  *
  * @example
- * // 아이콘과 함께 사용
- * <TextLink
- *   href="/detail"
- *   text="자세히 보기"
- *   trailingIcon="medium_arrow_right"
- * />
+ * // Next.js Link와 함께 사용
+ * import Link from 'next/link';
+ * <TextLink as={Link} href="/about" text="소개" />
  *
  * @example
- * // 외부 링크로 사용
+ * // 외부 링크
  * <TextLink
  *   href="https://example.com"
  *   text="외부 사이트 방문"
  *   target="_blank"
  *   rel="noopener noreferrer"
  * />
- *
- * @example
- * // 작은 텍스트 크기로 사용
- * <TextLink
- *   href="/help"
- *   text="도움말"
- *   isTextSmall
- *   leadingIcon="small_help"
- * />
- *
- * @example
- * // 프로그래매틱 네비게이션과 함께
- * <TextLink
- *   href="/dashboard"
- *   text="대시보드"
- *   onClick={(e) => {
- *     // 추가 로직 실행 가능
- *     console.log('대시보드로 이동');
- *   }}
- * />
  */
-declare const TextLink: ({ href, text, leadingIcon, trailingIcon, isTextSmall, isGray, isUnderline, className, ...rest }: TextLinkProps) => import("react/jsx-runtime").JSX.Element;
+declare const TextLink: ({ as: Component, href, text, leadingIcon, trailingIcon, isTextSmall, isGray, isUnderline, className, ...rest }: TextLinkProps) => import("react/jsx-runtime").JSX.Element;
 export { TextLink };