@krds.ui/vue 0.0.19 → 0.0.20

package/dist/types/index.d.ts

@@ -18,6 +18,7 @@ export declare type AlertType = 'danger' | 'ok' | 'info';
 
 /**
  * 정렬 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type Alignment = 'left' | 'center' | 'right' | 'justify';
 
@@ -244,6 +245,7 @@ declare namespace components {
 
 /**
  * 컴포넌트 슬롯 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare interface ComponentSlots {
     default?: () => unknown;
@@ -252,6 +254,7 @@ export declare interface ComponentSlots {
 
 /**
  * 컴포넌트 상태 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type ComponentState = 'default' | 'hover' | 'active' | 'focus' | 'disabled';
 
@@ -259,11 +262,13 @@ declare type ContextualHelpPosition = 'top left' | 'top center' | 'top right' |
 
 /**
  * CSS 변수 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type CSSCustomProperties = Record<`--${string}`, string | number>;
 
 /**
  * 방향 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type Direction = 'horizontal' | 'vertical';
 
@@ -302,6 +307,7 @@ export declare interface FileInfo {
  *
  * @param prefix - ID 접두사
  * @returns 고유한 ID 문자열
+ * @deprecated 모듈 전역 카운터라 SSR에서 요청 간 값이 공유된다. Vue의 `useId()`를 사용. 다음 breaking 릴리스에서 제거 예정
  */
 export declare function generateId(prefix?: string): string;
 
@@ -310,11 +316,13 @@ export declare function generateId(prefix?: string): string;
  * 브라우저와 Node.js 환경에서 모두 작동합니다.
  *
  * @returns 7자리 랜덤 문자열
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare function generateUid(): string;
 
 /**
  * 아이콘 속성
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare interface IconProps {
     /** 아이콘 이름 */
@@ -327,6 +335,7 @@ export declare interface IconProps {
 
 /**
  * 입력 상태 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type InputState = ComponentState | 'error' | 'success';
 
@@ -1271,6 +1280,7 @@ export declare interface KrdsCoachMarkProps extends BaseComponentProps {
 
 /**
  * KRDS 컴포넌트 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type KrdsComponent<Props = object, Slots = object, Emits = object> = Component & {
     __krdsComponent: true;
@@ -1317,9 +1327,9 @@ export declare const KrdsContextualHelp: DefineComponent<ExtractPropTypes<{
         default: string;
     };
 }>> & Readonly<{}>, {
+    position: ContextualHelpPosition;
     tooltipTitle: string;
     helpIcon: boolean;
-    position: ContextualHelpPosition;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1470,6 +1480,11 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
         type: NumberConstructor;
         default: undefined;
     };
+    /** 달력을 body에 렌더 (overflow로 잘리는 컨테이너 안에서 사용. 모달 안에서는 쓰지 않음) */
+    teleport: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** CSS 클래스 */
     class: {
         type: StringConstructor;
@@ -1549,6 +1564,11 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
         type: NumberConstructor;
         default: undefined;
     };
+    /** 달력을 body에 렌더 (overflow로 잘리는 컨테이너 안에서 사용. 모달 안에서는 쓰지 않음) */
+    teleport: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /** CSS 클래스 */
     class: {
         type: StringConstructor;
@@ -1580,6 +1600,7 @@ export declare const KrdsDateInput: DefineComponent<ExtractPropTypes<{
     holidays: string[];
     initialYear: number;
     initialMonth: number;
+    teleport: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -1617,6 +1638,8 @@ export declare interface KrdsDateInputProps extends BaseFormProps {
     initialYear?: number;
     /** 초기 표시 월 (기본: 현재 월) */
     initialMonth?: number;
+    /** 달력을 body에 렌더 (overflow로 잘리는 컨테이너 안에서 사용. 모달 안에서는 쓰지 않음) */
+    teleport?: boolean;
 }
 
 export declare const KrdsDisclosure: DefineComponent<ExtractPropTypes<{
@@ -3796,9 +3819,16 @@ export declare interface KrdsSideNavigationProps {
  *
  * @example
  * ```vue
+ * <!-- 단일 링크 -->
  * <KrdsSkipLink href="#main-content">본문 바로가기</KrdsSkipLink>
- * <KrdsSkipLink href="#breadcrumb">본문 바로가기</KrdsSkipLink>
- * <KrdsSkipLink href="#gnb">메인메뉴 바로가기</KrdsSkipLink>
+ *
+ * <!-- 여러 링크: 컴포넌트를 나란히 두면 #krds-skip-link가 중복되므로 links 사용 -->
+ * <KrdsSkipLink
+ *   :links="[
+ *     { href: '#main-content', label: '본문 바로가기' },
+ *     { href: '#gnb', label: '메인메뉴 바로가기' }
+ *   ]"
+ * />
  * ```
  */
 export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
@@ -3808,9 +3838,22 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
      */
     href: {
         type: StringConstructor;
-        required: true;
+        default: undefined;
         validator: (value: string) => boolean;
     };
+    /**
+     * 여러 건너뛰기 링크 (하나의 래퍼 안에 렌더링, 지정 시 href·기본 슬롯 대신 사용)
+     */
+    links: {
+        type: PropType<{
+            href: string;
+            label: string;
+        }[]>;
+        default: undefined;
+        validator: (value: {
+            href: string;
+        }[]) => boolean;
+    };
     /**
      * 추가 CSS 클래스
      */
@@ -3832,9 +3875,22 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
      */
     href: {
         type: StringConstructor;
-        required: true;
+        default: undefined;
         validator: (value: string) => boolean;
     };
+    /**
+     * 여러 건너뛰기 링크 (하나의 래퍼 안에 렌더링, 지정 시 href·기본 슬롯 대신 사용)
+     */
+    links: {
+        type: PropType<{
+            href: string;
+            label: string;
+        }[]>;
+        default: undefined;
+        validator: (value: {
+            href: string;
+        }[]) => boolean;
+    };
     /**
      * 추가 CSS 클래스
      */
@@ -3851,15 +3907,25 @@ export declare const KrdsSkipLink: DefineComponent<ExtractPropTypes<{
     };
 }>> & Readonly<{}>, {
     class: string | unknown[] | Record<string, any>;
+    href: string;
     id: string;
+    links: {
+        href: string;
+        label: string;
+    }[];
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
 /**
  * KRDS SkipLink 컴포넌트 속성
  */
 export declare interface KrdsSkipLinkProps extends BaseComponentProps {
-    /** 건너뛸 대상 요소의 ID */
-    href: string;
+    /** 건너뛸 대상 요소의 ID (단일 링크, 기본 슬롯이 링크 텍스트) */
+    href?: string;
+    /** 여러 건너뛰기 링크 (하나의 래퍼 안에 렌더링, 지정 시 href·기본 슬롯 대신 사용) */
+    links?: {
+        href: string;
+        label: string;
+    }[];
 }
 
 export declare const KrdsSpinner: DefineComponent<ExtractPropTypes<{
@@ -4981,6 +5047,7 @@ export declare interface LayoutSize {
 
 /**
  * 로딩 상태 속성
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare interface LoadingProps {
     /** 로딩 중 여부 */
@@ -5124,19 +5191,23 @@ export declare interface NavigationItem {
 /**
  * 유틸리티 타입들
  */
+/** @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정 */
 export declare type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 
 /**
  * 위치 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type Position = 'top' | 'bottom' | 'left' | 'right';
 
+/** @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정 */
 export declare type RequiredKeys<T> = {
     [K in keyof T]-?: object extends Pick<T, K> ? never : K;
 }[keyof T];
 
 /**
  * 반응형 값 타입
+ * @deprecated 라이브러리에서 쓰이지 않아 다음 breaking 릴리스에서 제거 예정
  */
 export declare type ResponsiveValue<T> = T | {
     mobile?: T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krds.ui/vue",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "description": "KRDS Vue Design System - 한국 정부 디자인 시스템 Vue 컴포넌트 라이브러리",
   "keywords": [
     "krds",
@@ -50,31 +50,33 @@
     "vue": "^3.5.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.58.12",
-    "@size-limit/file": "^14.0.0",
-    "@storybook/addon-a11y": "^10.6.1",
-    "@storybook/addon-docs": "^10.6.1",
-    "@storybook/addon-vitest": "^10.6.1",
-    "@storybook/vue3-vite": "^10.6.1",
-    "@tsconfig/node24": "^24.0.4",
-    "@types/node": "^26.2.0",
-    "@vitejs/plugin-vue": "^6.0.8",
-    "@vitest/browser": "^4.1.10",
-    "@vitest/browser-playwright": "^4.1.10",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@microsoft/api-extractor": "^7.59.4",
+    "@size-limit/file": "^14.1.0",
+    "@size-limit/rolldown": "^14.1.0",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/user-event": "^14.6.7",
+    "@testing-library/vue": "^8.1.0",
+    "@tsconfig/node24": "^24.0.5",
+    "@types/node": "^26.6.4",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "@vitest/browser": "^4.1.11",
+    "@vitest/browser-playwright": "^4.1.11",
+    "@vitest/coverage-v8": "^4.1.11",
+    "axe-core": "~4.13.0",
     "oxfmt": "^0.71.0",
-    "oxlint": "^1.86.0",
-    "playwright": "^1.62.1",
-    "sass": "^1.102.0",
-    "size-limit": "^14.0.0",
+    "oxlint": "^1.87.0",
+    "playwright": "^1.63.0",
+    "sass": "^1.105.1",
+    "size-limit": "^14.1.0",
     "source-map-explorer": "^2.5.3",
-    "storybook": "^10.6.1",
     "typescript": "6.0.3",
     "typescript7": "npm:typescript@^7.0.2",
-    "vite": "^8.2.1",
-    "vite-plugin-dts": "^5.0.3",
-    "vitest": "^4.1.10",
-    "vue": "^3.5.41"
+    "vite": "^8.3.3",
+    "vite-plugin-dts": "^5.1.2",
+    "vitepress": "2.0.0-alpha.20",
+    "vitest": "^4.1.11",
+    "vue": "^3.5.43",
+    "vue-component-meta": "^3.3.12"
   },
   "publishConfig": {
     "access": "public",
@@ -87,25 +89,32 @@
   "size-limit": [
     {
       "path": "dist/krds-vue.es.js",
-      "limit": "25 kB"
+      "limit": "25 kB",
+      "rolldown": false
     },
     {
       "path": "dist/style.css",
-      "limit": "60 kB"
+      "limit": "60 kB",
+      "rolldown": false
+    },
+    {
+      "name": "tree-shaking: { KrdsButton }",
+      "path": "dist/krds-vue.es.js",
+      "import": "{ KrdsButton }",
+      "limit": "2 kB"
     }
   ],
   "scripts": {
-    "dev": "vite",
     "build": "pnpm run type-check && pnpm run build:lib",
     "build:lib": "vite build",
-    "preview": "vite preview",
     "test": "vitest",
     "test:coverage": "vitest --coverage",
     "type-check": "node node_modules/typescript7/bin/tsc --noEmit",
     "lint": "oxlint",
     "format": "oxfmt",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build && node scripts/storybook-seo.mjs",
-    "bundle-size": "size-limit"
+    "bundle-size": "size-limit",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   }
 }