@krds.ui/vue 0.0.12 → 0.0.14

package/dist/types/index.d.ts

@@ -183,6 +183,11 @@ declare type __VLS_WithTemplateSlots_6<T, S> = T & {
     };
 };
 
+/**
+ * 알림 타입
+ */
+export declare type AlertType = 'danger' | 'ok' | 'info';
+
 /**
  * 정렬 타입
  */
@@ -502,6 +507,29 @@ export declare interface KrdsContextualHelpProps {
     position?: 'top left' | 'top center' | 'top right' | 'bottom left' | 'bottom center' | 'bottom right';
 }
 
+export declare const KrdsCriticalAlerts: DefineComponent<KrdsCriticalAlertsProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsCriticalAlertsProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS Critical Alerts 컴포넌트 이벤트
+ */
+export declare interface KrdsCriticalAlertsEmits {
+    (e: 'link-click', event: MouseEvent): void;
+}
+
+/**
+ * KRDS Critical Alerts 컴포넌트 속성
+ */
+export declare interface KrdsCriticalAlertsProps extends BaseComponentProps {
+    /** 알림 타입 */
+    type: AlertType;
+    /** 알림 메시지 */
+    message: string;
+    /** 링크 URL */
+    linkHref?: string;
+    /** 링크 텍스트 */
+    linkText?: string;
+}
+
 export declare const KrdsDateInput: DefineComponent<KrdsDateInputProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 focus: (event: FocusEvent) => any;
 input: (event: Event) => any;
@@ -571,6 +599,25 @@ export declare interface KrdsDateInputProps extends BaseFormProps {
     initialMonth?: number;
 }
 
+export declare const KrdsDisclosure: DefineComponent<KrdsDisclosureProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsDisclosureProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS Disclosure 컴포넌트 이벤트
+ */
+export declare interface KrdsDisclosureEmits {
+    (e: 'update:modelValue', value: boolean): void;
+}
+
+/**
+ * KRDS Disclosure 컴포넌트 속성
+ */
+export declare interface KrdsDisclosureProps extends BaseComponentProps {
+    /** 디스클로저 제목 */
+    title: string;
+    /** 확장 상태 (v-model) */
+    modelValue?: boolean;
+}
+
 export declare const KrdsFileUpload: DefineComponent<ExtractPropTypes<    {
 modelValue: {
 type: () => FileInfo[];
@@ -656,7 +703,9 @@ id: {
 type: StringConstructor;
 default: undefined;
 };
-}>, () => null, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview")[], "update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview", PublicProps, Readonly<ExtractPropTypes<    {
+}>, () => VNode<RendererNode, RendererElement, {
+[key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, ("update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview")[], "update:modelValue" | "file-added" | "file-removed" | "file-error" | "upload-start" | "upload-progress" | "upload-complete" | "upload-error" | "clear-all" | "download" | "preview", PublicProps, Readonly<ExtractPropTypes<    {
 modelValue: {
 type: () => FileInfo[];
 default: () => never[];
@@ -830,6 +879,16 @@ export declare interface KrdsFileUploadProps extends BaseFormProps {
     showClearAll?: boolean;
 }
 
+export declare const KrdsFooter: DefineComponent<KrdsFooterProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsFooterProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS Footer 컴포넌트 속성
+ */
+export declare interface KrdsFooterProps extends BaseComponentProps {
+    /** Footer ID */
+    id?: string;
+}
+
 export declare const KrdsFormGroup: DefineComponent<BaseComponentProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<BaseComponentProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -871,6 +930,61 @@ export declare interface KrdsFormLabelProps extends BaseComponentProps {
     for?: string;
 }
 
+export declare const KrdsHeader: DefineComponent<ExtractPropTypes<    {
+id: {
+type: StringConstructor;
+default: string;
+};
+mobileNavId: {
+type: StringConstructor;
+default: string;
+};
+class: {
+type: StringConstructor;
+default: undefined;
+};
+}>, () => VNode<RendererNode, RendererElement, {
+[key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<    {
+id: {
+type: StringConstructor;
+default: string;
+};
+mobileNavId: {
+type: StringConstructor;
+default: string;
+};
+class: {
+type: StringConstructor;
+default: undefined;
+};
+}>> & Readonly<{}>, {
+class: string;
+id: string;
+mobileNavId: string;
+}, SlotsType<{
+/** 유틸리티 메뉴 슬롯 */
+utility?(): VNode[];
+/** 브랜딩 영역 슬롯 (로고, 액션 버튼) */
+branding?(): VNode[];
+/** 데스크탑 네비게이션 메뉴 슬롯 */
+navigation?(): VNode[];
+/** 모바일 네비게이션 메뉴 슬롯 */
+mobileNavigation?(): VNode[];
+}>, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * KRDS Header 컴포넌트 속성
+ */
+export declare interface KrdsHeaderProps {
+    /** 헤더 ID */
+    id?: string;
+    /** 모바일 메뉴 ID */
+    mobileNavId?: string;
+    /** 추가 CSS 클래스 */
+    class?: string;
+}
+
 export declare const KrdsIcon: DefineComponent<KrdsIconProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsIconProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -881,6 +995,22 @@ export declare interface KrdsIconProps extends BaseComponentProps {
     name: string;
 }
 
+export declare const KrdsIdentifier: DefineComponent<KrdsIdentifierProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsIdentifierProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS Identifier 컴포넌트 이벤트
+ */
+export declare interface KrdsIdentifierEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+
+/**
+ * KRDS Identifier 컴포넌트 속성
+ */
+export declare interface KrdsIdentifierProps extends BaseComponentProps {
+    logoLabel?: string;
+}
+
 export declare const KrdsInPageNavigation: DefineComponent<KrdsInPageNavigationProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsInPageNavigationProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -968,6 +1098,27 @@ export declare interface KrdsLanguageSwitcherProps extends BaseComponentProps {
     dropPosition?: DropdownPosition;
 }
 
+export declare const KrdsLayout: DefineComponent<KrdsLayoutProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsLayoutProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS Layout 컴포넌트 이벤트
+ */
+export declare interface KrdsLayoutEmits {
+    resize: [size: LayoutSize];
+    scroll: [details: ScrollDetails];
+    'scroll-height': [height: number];
+}
+
+/**
+ * KRDS Layout 컴포넌트 속성
+ */
+export declare interface KrdsLayoutProps extends BaseComponentProps {
+    /** 레이아웃 ID */
+    id?: string;
+    /** 스크롤 감지 활성화 여부 */
+    enableScrollDetection?: boolean;
+}
+
 export declare const KrdsLink: DefineComponent<KrdsLinkProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsLinkProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -1215,6 +1366,37 @@ export declare interface KrdsSelectProps extends BaseFormProps {
     sort?: boolean;
 }
 
+export declare const KrdsSideNavigation: DefineComponent<    {
+title: string;
+modelValue?: SideNavItem[] | undefined;
+}, () => VNode<RendererNode, RendererElement, {
+[key: string]: any;
+}>, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, "update:modelValue"[], "update:modelValue", PublicProps, Readonly<{
+title: string;
+modelValue?: SideNavItem[] | undefined;
+}> & Readonly<{
+"onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+}>, {
+modelValue: SideNavItem[];
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+/**
+ * KRDS SideNavigation 컴포넌트 이벤트
+ */
+export declare interface KrdsSideNavigationEmits {
+    (event: 'update:modelValue', value: SideNavItem[]): void;
+}
+
+/**
+ * KRDS SideNavigation 컴포넌트 속성
+ */
+export declare interface KrdsSideNavigationProps {
+    /** 네비게이션 제목 */
+    title: string;
+    /** 메뉴 아이템 배열 */
+    modelValue?: SideNavItem[];
+}
+
 /**
  * KRDS SkipLink 컴포넌트
  *
@@ -1342,6 +1524,37 @@ export declare interface KrdsStepProps extends BaseComponentProps {
     status?: 'done' | 'active' | 'pending';
 }
 
+export declare const KrdsStructuredList: DefineComponent<KrdsStructuredListProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsStructuredListProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS StructuredList 컴포넌트 속성
+ */
+export declare interface KrdsStructuredListProps extends BaseComponentProps {
+    /** 전체 타입 여부 */
+    full?: boolean;
+}
+
+export declare const KrdsTable: DefineComponent<KrdsTableProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsTableProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS Table 컴포넌트 이벤트
+ */
+export declare interface KrdsTableEmits {
+    (e: 'row-click', row: TableRow, index: number): void;
+}
+
+/**
+ * KRDS Table 컴포넌트 속성
+ */
+export declare interface KrdsTableProps extends BaseComponentProps {
+    /** 테이블 캡션 */
+    caption?: string;
+    /** 테이블 열 정의 */
+    columns: TableColumn[];
+    /** 테이블 행 데이터 */
+    rows: TableRow[];
+}
+
 export declare const KrdsTag: DefineComponent<KrdsTagProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsTagProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -1589,6 +1802,18 @@ export declare interface KrdsTextareaProps extends BaseFormProps {
     resize?: 'none' | 'both' | 'horizontal' | 'vertical';
 }
 
+export declare const KrdsTextList: DefineComponent<KrdsTextListProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsTextListProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS TextList 컴포넌트 속성
+ */
+export declare interface KrdsTextListProps extends BaseComponentProps {
+    /** 리스트 타입 */
+    type?: 'ul' | 'ol';
+    /** 스타일 변형 */
+    variant?: 'decimal' | 'dash' | 'hollow' | 'ordered';
+}
+
 export declare const KrdsToggleSwitch: DefineComponent<KrdsToggleSwitchProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsToggleSwitchProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 /**
@@ -1623,6 +1848,34 @@ export declare interface KrdsTooltipProps extends BaseComponentProps {
     disabled?: boolean;
 }
 
+export declare const KrdsTts: DefineComponent<KrdsTtsProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<KrdsTtsProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * KRDS TTS 컴포넌트 이벤트
+ */
+export declare interface KrdsTtsEmits {
+    (e: 'play', text: string): void;
+    (e: 'pause'): void;
+    (e: 'end'): void;
+    (e: 'error', error: Error): void;
+}
+
+/**
+ * KRDS TTS 컴포넌트 속성
+ */
+export declare interface KrdsTtsProps extends BaseComponentProps {
+    /** 읽어줄 텍스트 */
+    text: string;
+    /** 레이블 텍스트 (미지정 시 아이콘만 표시) */
+    label?: string;
+    /** 버튼 크기 */
+    size?: TtsSize;
+    /** 아이콘 타입 */
+    icon?: TtsIcon;
+    /** 비활성화 여부 */
+    disabled?: boolean;
+}
+
 /**
  * KRDS Vue 플러그인
  */
@@ -1643,6 +1896,14 @@ declare type LanguageData = {
     url?: string;
 };
 
+/**
+ * 레이아웃 크기 정보
+ */
+export declare interface LayoutSize {
+    width: number;
+    height: number;
+}
+
 /**
  * 로딩 상태 속성
  */
@@ -1688,6 +1949,16 @@ export declare type ResponsiveValue<T> = T | {
     desktop?: T;
 };
 
+/**
+ * 스크롤 상세 정보
+ */
+export declare interface ScrollDetails {
+    scrollY: number;
+    scrollHeight: number;
+    direction: 'up' | 'down' | null;
+    timestamp: number;
+}
+
 /**
  * KRDS Select 옵션 타입
  */
@@ -1700,6 +1971,52 @@ export declare interface SelectOption {
     disabled?: boolean;
 }
 
+/**
+ * 사이드 네비게이션 아이템 인터페이스
+ */
+export declare interface SideNavItem {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL */
+    href?: string;
+    /** 확장 상태 */
+    expanded?: boolean;
+    /** 하위 아이템 */
+    subItems?: SideNavSubItem[];
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
+/**
+ * 사이드 네비게이션 팝업 아이템 인터페이스 (4depth)
+ */
+export declare interface SideNavPopupItem {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL */
+    href?: string;
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
+/**
+ * 사이드 네비게이션 하위 아이템 인터페이스
+ */
+export declare interface SideNavSubItem {
+    /** 텍스트 */
+    text: string;
+    /** 링크 URL */
+    href?: string;
+    /** 확장 상태 (3depth popup용) */
+    expanded?: boolean;
+    /** 팝업 제목 (3depth popup용) */
+    popupTitle?: string;
+    /** 하위 아이템 (4depth용) */
+    subItems?: SideNavPopupItem[];
+    /** 클릭 핸들러 */
+    onClick?: (event: MouseEvent) => void;
+}
+
 /**
  * 기본 크기 타입 (KRDS 실제 규격)
  */
@@ -1711,13 +2028,52 @@ declare type StepsData = {
     description: string;
 };
 
+/**
+ * 테이블 열 정의
+ */
+export declare interface TableColumn {
+    /** 고유 ID - 컬럼 식별자 */
+    name: string;
+    /** 헤더 라벨 */
+    label: string;
+    /** 행 객체 속성명 또는 함수 */
+    field: string | ((row: TableRow) => unknown);
+    /** 필수 컬럼 여부 (visible-columns 사용시 항상 표시) */
+    required?: boolean;
+    /** 정렬 */
+    align?: 'left' | 'center' | 'right';
+    /** body td 스타일 */
+    style?: string | ((row: TableRow) => string);
+    /** body td 클래스 */
+    classes?: string | ((row: TableRow) => string);
+    /** header th 스타일 */
+    headerStyle?: string;
+    /** header th 클래스 */
+    headerClasses?: string;
+}
+
+/**
+ * 테이블 행 데이터
+ */
+export declare type TableRow = Record<string, unknown>;
+
 declare type TooltipType = 'default' | 'icon' | 'button';
 
+/**
+ * TTS 아이콘 타입
+ */
+export declare type TtsIcon = 'volume' | 'play';
+
+/**
+ * TTS 사이즈 타입
+ */
+export declare type TtsSize = 'xsmall' | 'small' | 'medium';
+
 /**
  * 버튼 변형 타입
  */
 export declare type Variant = 'primary' | 'secondary' | 'tertiary';
 
-export declare const version = "__VERSION__";
+export declare const version: string;
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krds.ui/vue",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "KRDS Vue Design System - 한국 정부 디자인 시스템 Vue 컴포넌트 라이브러리",
   "keywords": [
     "krds",
@@ -24,23 +24,20 @@
   "license": "MIT",
   "author": "Initializer Team",
   "type": "module",
-  "main": "./dist/krds-vue.umd.js",
+  "main": "./dist/krds-vue.es.js",
   "module": "./dist/krds-vue.es.js",
   "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
-      "import": "./dist/krds-vue.es.js",
-      "require": "./dist/krds-vue.umd.js"
+      "import": "./dist/krds-vue.es.js"
     },
     "./dist/style.css": "./dist/style.css",
-    "./style": "./dist/style.css",
-    "./styles/*": "./dist/styles/*",
-    "./styles": {
-      "types": "./dist/types/styles/index.d.ts",
-      "import": "./dist/styles/index.js"
-    }
+    "./style": "./dist/style.css"
   },
+  "sideEffects": [
+    "**/*.css"
+  ],
   "files": [
     "dist"
   ],
@@ -48,37 +45,41 @@
     "vue": "^3.5.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@storybook/addon-a11y": "^10.1.10",
-    "@storybook/addon-docs": "^10.1.10",
-    "@storybook/vue3-vite": "^10.1.10",
-    "@tsconfig/node20": "^20.1.8",
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.0",
-    "@typescript-eslint/parser": "^8.50.0",
-    "@vitejs/plugin-vue": "^6.0.3",
-    "@vitest/coverage-v8": "^4.0.16",
+    "@eslint/js": "^10.0.1",
+    "@microsoft/api-extractor": "^7.58.1",
+    "@storybook/addon-a11y": "^10.3.4",
+    "@storybook/addon-docs": "^10.3.4",
+    "@storybook/addon-vitest": "^10.3.4",
+    "@storybook/vue3-vite": "^10.3.4",
+    "@tsconfig/node20": "^20.1.9",
+    "@types/node": "^25.5.2",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "@vitejs/plugin-vue": "^6.0.5",
+    "@vitest/browser": "^4.1.8",
+    "@vitest/browser-playwright": "^4.1.8",
+    "@vitest/coverage-v8": "^4.1.8",
     "@vue/eslint-config-prettier": "^10.2.0",
-    "@vue/eslint-config-typescript": "^14.6.0",
+    "@vue/eslint-config-typescript": "^14.7.0",
     "@vue/test-utils": "^2.4.6",
-    "@vue/tsconfig": "^0.8.1",
-    "eslint": "^9.39.2",
-    "eslint-plugin-storybook": "^10.1.10",
-    "eslint-plugin-vue": "^10.6.2",
-    "jsdom": "^27.3.0",
-    "playwright": "^1.57.0",
-    "prettier": "^3.7.4",
-    "sass": "^1.97.0",
+    "@vue/tsconfig": "^0.9.1",
+    "eslint": "^10.2.0",
+    "eslint-plugin-storybook": "^10.3.4",
+    "eslint-plugin-vue": "^10.8.0",
+    "jsdom": "^29.0.1",
+    "playwright": "^1.59.1",
+    "prettier": "^3.8.1",
+    "sass": "^1.99.0",
     "source-map-explorer": "^2.5.3",
     "standard-version": "^9.5.0",
-    "storybook": "^10.1.10",
+    "storybook": "^10.3.4",
     "typescript": "5.9.3",
-    "vite": "^7.3.0",
+    "vite": "^8.0.16",
     "vite-plugin-dts": "^4.5.4",
-    "vitest": "^4.0.16",
-    "vue": "^3.5.26",
-    "vue-eslint-parser": "^10.2.0",
-    "vue-tsc": "^3.1.8"
+    "vitest": "^4.1.8",
+    "vue": "^3.5.32",
+    "vue-eslint-parser": "^10.4.0",
+    "vue-tsc": "^3.2.6"
   },
   "publishConfig": {
     "access": "public",
@@ -99,7 +100,7 @@
     "lint": "eslint . --fix",
     "format": "prettier --write src/",
     "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build",
+    "build-storybook": "storybook build && node scripts/storybook-seo.mjs",
     "bundle-size": "vite build && echo 'Bundle size check removed due to bundlewatch security vulnerability'",
     "release": "standard-version",
     "release:minor": "standard-version --release-as minor",