@nexus-cross/design-system 1.0.0

package/dist/schemas/_all.json

@@ -0,0 +1,2250 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "description": "@nexus-cross/design-system component schemas",
+  "components": {
+    "accordion": {
+      "$ref": "#/definitions/accordionPropsSchema",
+      "definitions": {
+        "accordionPropsSchema": {
+          "type": "object",
+          "properties": {
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "고유 ID"
+                  },
+                  "trigger": {
+                    "description": "트리거 내용 (ReactNode)"
+                  },
+                  "content": {
+                    "description": "펼침 내용 (ReactNode)"
+                  },
+                  "disabled": {
+                    "type": "boolean",
+                    "description": "비활성"
+                  },
+                  "className": {
+                    "type": "string"
+                  },
+                  "triggerClassName": {
+                    "type": "string"
+                  },
+                  "contentClassName": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "additionalProperties": false
+              },
+              "description": "아코디언 항목 배열 (필수)"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "single",
+                "multiple"
+              ],
+              "default": "single",
+              "description": "단일/다중 열기"
+            },
+            "collapsible": {
+              "type": "boolean",
+              "default": true,
+              "description": "전부 접기 가능"
+            },
+            "value": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ],
+              "description": "제어 모드"
+            },
+            "defaultValue": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ],
+              "description": "비제어 초기값"
+            },
+            "onValueChange": {
+              "description": "열린 항목 변경 콜백 (value: string | string[]) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "Root 스타일"
+            }
+          },
+          "required": [
+            "items"
+          ],
+          "additionalProperties": false,
+          "description": "아코디언. items 배열 방식과 컴포저블 방식 모두 지원."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "avatar": {
+      "$ref": "#/definitions/avatarPropsSchema",
+      "definitions": {
+        "avatarPropsSchema": {
+          "type": "object",
+          "properties": {
+            "src": {
+              "type": "string",
+              "description": "이미지 URL"
+            },
+            "alt": {
+              "type": "string",
+              "description": "대체 텍스트"
+            },
+            "fallback": {
+              "description": "이미지 로드 실패 시 표시 (ReactNode)"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "xs",
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "shape": {
+              "type": "string",
+              "enum": [
+                "circle",
+                "square"
+              ],
+              "default": "circle",
+              "description": "형태"
+            },
+            "children": {
+              "description": "커스텀 이미지 요소 (예: Next.js Image)"
+            },
+            "onImageError": {
+              "description": "이미지 로드 실패 콜백 () => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "아바타. 이미지, 폴백 텍스트, children 지원."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "button": {
+      "$ref": "#/definitions/buttonPropsSchema",
+      "definitions": {
+        "buttonPropsSchema": {
+          "type": "object",
+          "properties": {
+            "semantic": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "secondary",
+                "normal",
+                "danger"
+              ],
+              "default": "primary",
+              "description": "색상 테마 (primary=주요, secondary=보조, normal=중립, danger=위험)"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "contained",
+                "outlined",
+                "subtle",
+                "ghost"
+              ],
+              "default": "contained",
+              "description": "시각 스타일 (contained=채움, outlined=테두리, subtle=연한배경, ghost=투명)"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "xl",
+                "lg",
+                "md",
+                "sm"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "radius": {
+              "type": "string",
+              "enum": [
+                "default",
+                "circle"
+              ],
+              "default": "default",
+              "description": "모서리 (default=size별 radius, circle=pill 형태)"
+            },
+            "asChild": {
+              "type": "boolean",
+              "description": "true면 자식 요소로 렌더링 (Slot 패턴)"
+            },
+            "detectDoubleClick": {
+              "type": "boolean",
+              "description": "500ms 내 더블 클릭 방지"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성 (aria-disabled 자동)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "인터랙티브 버튼. semantic(색상)×variant(스타일) 2축 시스템. asChild로 렌더링 요소 변경 가능."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "carousel": {
+      "$ref": "#/definitions/carouselPropsSchema",
+      "definitions": {
+        "carouselPropsSchema": {
+          "type": "object",
+          "properties": {
+            "opts": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "Embla 옵션 (loop, align 등)"
+            },
+            "plugins": {
+              "type": "array",
+              "description": "Embla 플러그인"
+            },
+            "onApiChange": {
+              "description": "Embla API 변경 콜백 (api: CarouselApi) => void"
+            },
+            "children": {
+              "description": "캐러셀 슬라이드 및 서브 컴포넌트 (ReactNode)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "캐러셀. Embla Carousel 기반. CarouselSlide, CarouselPrev, CarouselNext, CarouselDots 서브 컴포넌트."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "carouselSlide": {
+      "$ref": "#/definitions/carouselSlidePropsSchema",
+      "definitions": {
+        "carouselSlidePropsSchema": {
+          "type": "object",
+          "properties": {
+            "className": {
+              "type": "string",
+              "description": "슬라이드 스타일 (basis-1/3 등으로 복수 노출)"
+            },
+            "children": {
+              "description": "슬라이드 내용 (ReactNode, 필수)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "캐러셀 슬라이드. Carousel 내부에서 사용."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "carouselButton": {
+      "$ref": "#/definitions/carouselButtonPropsSchema",
+      "definitions": {
+        "carouselButtonPropsSchema": {
+          "type": "object",
+          "properties": {
+            "className": {
+              "type": "string",
+              "description": "버튼 스타일 오버라이드"
+            },
+            "children": {
+              "description": "커스텀 아이콘 (ReactNode, 기본: chevron)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "CarouselPrev / CarouselNext. 이전/다음 내비게이션 버튼."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "carouselDots": {
+      "$ref": "#/definitions/carouselDotsPropsSchema",
+      "definitions": {
+        "carouselDotsPropsSchema": {
+          "type": "object",
+          "properties": {
+            "className": {
+              "type": "string",
+              "description": "도트 컨테이너 스타일"
+            }
+          },
+          "additionalProperties": false,
+          "description": "CarouselDots. 슬라이드 인디케이터 도트."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "checkBox": {
+      "$ref": "#/definitions/checkBoxPropsSchema",
+      "definitions": {
+        "checkBoxPropsSchema": {
+          "type": "object",
+          "properties": {
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "shape": {
+              "type": "string",
+              "enum": [
+                "square",
+                "round"
+              ],
+              "default": "square",
+              "description": "형태"
+            },
+            "checked": {
+              "type": "boolean",
+              "description": "체크 상태"
+            },
+            "indeterminate": {
+              "type": "boolean",
+              "description": "불확정 상태 (aria-checked=\"mixed\")"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "readOnly": {
+              "type": "boolean",
+              "description": "읽기 전용. 네이티브 input readOnly와 동일하게 체크 상태 변경 불가"
+            },
+            "label": {
+              "description": "라벨 텍스트 (ReactNode)"
+            },
+            "onCheckedChange": {
+              "description": "체크 상태 변경 콜백 (checked: boolean) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "체크박스. 네이티브 input 기반, square/round 형태 지원."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "chip": {
+      "$ref": "#/definitions/chipPropsSchema",
+      "definitions": {
+        "chipPropsSchema": {
+          "type": "object",
+          "properties": {
+            "variant": {
+              "type": "string",
+              "enum": [
+                "default",
+                "filled",
+                "outline",
+                "accent"
+              ],
+              "default": "default",
+              "description": "스타일"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "asChild": {
+              "type": "boolean",
+              "description": "true면 자식 요소로 렌더링 (Slot 패턴)"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성 (aria-disabled 자동)"
+            },
+            "onClose": {
+              "description": "닫기 버튼 클릭 콜백 () => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "칩/태그/뱃지. onClose prop으로 닫기 버튼 표시."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "clientOnly": {
+      "$ref": "#/definitions/clientOnlyPropsSchema",
+      "definitions": {
+        "clientOnlyPropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "클라이언트에서만 렌더링할 요소 (ReactNode, 필수)"
+            },
+            "fallback": {
+              "description": "SSR 중 표시할 대체 UI (ReactNode, 기본: null)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "클라이언트 전용 렌더링. SSR 환경에서 hydration mismatch 방지."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "countdown": {
+      "$ref": "#/definitions/countdownPropsSchema",
+      "definitions": {
+        "countdownPropsSchema": {
+          "type": "object",
+          "properties": {
+            "endTimestamp": {
+              "type": "number",
+              "description": "종료 시각 (Unix ms, 필수)"
+            },
+            "separator": {
+              "default": ":",
+              "description": "구분자 (ReactNode)"
+            },
+            "showDays": {
+              "type": "boolean",
+              "default": true,
+              "description": "일 단위 표시"
+            },
+            "labels": {
+              "type": "object",
+              "properties": {
+                "days": {
+                  "type": "string"
+                },
+                "hours": {
+                  "type": "string"
+                },
+                "minutes": {
+                  "type": "string"
+                },
+                "seconds": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false,
+              "description": "단위 라벨"
+            },
+            "render": {
+              "description": "커스텀 렌더 함수"
+            },
+            "onEnd": {
+              "description": "카운트다운 종료 콜백 () => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "required": [
+            "endTimestamp"
+          ],
+          "additionalProperties": false,
+          "description": "카운트다운 타이머."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "counter": {
+      "$ref": "#/definitions/counterPropsSchema",
+      "definitions": {
+        "counterPropsSchema": {
+          "type": "object",
+          "properties": {
+            "endValue": {
+              "type": "number",
+              "description": "목표 값 (필수)"
+            },
+            "startValue": {
+              "type": "number",
+              "default": 0,
+              "description": "시작 값"
+            },
+            "duration": {
+              "type": "number",
+              "default": 1500,
+              "description": "애니메이션 시간 (ms)"
+            },
+            "delay": {
+              "type": "number",
+              "default": 0,
+              "description": "시작 지연 (ms)"
+            },
+            "separator": {
+              "type": "boolean",
+              "default": true,
+              "description": "천 단위 구분"
+            },
+            "digits": {
+              "type": "number",
+              "default": 0,
+              "description": "소수 자릿수"
+            },
+            "triggerOnView": {
+              "type": "boolean",
+              "default": false,
+              "description": "뷰포트 진입 시 시작"
+            },
+            "onEnd": {
+              "description": "카운트 완료 콜백 () => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "required": [
+            "endValue"
+          ],
+          "additionalProperties": false,
+          "description": "숫자 카운트 애니메이션."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "dataList": {
+      "$ref": "#/definitions/dataListPropsSchema",
+      "definitions": {
+        "dataListPropsSchema": {
+          "type": "object",
+          "properties": {
+            "list": {
+              "anyOf": [
+                {
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "렌더링할 데이터 배열. null이면 로딩 상태 (필수)"
+            },
+            "noDataMessage": {
+              "description": "빈 배열일 때 표시할 메시지 (string | ReactElement)"
+            },
+            "errorFallback": {
+              "description": "에러 발생 시 표시할 fallback (ReactNode)"
+            },
+            "loadingElement": {
+              "description": "로딩 중 표시할 커스텀 요소 (기본: Spinner)"
+            },
+            "skeletonElement": {
+              "description": "로딩 중 표시할 스켈레톤 요소 (ReactElement)"
+            },
+            "skeletonCount": {
+              "type": "number",
+              "default": 3,
+              "description": "스켈레톤 반복 개수"
+            },
+            "loading": {
+              "type": "boolean",
+              "default": false,
+              "description": "강제 로딩 상태"
+            },
+            "children": {
+              "description": "각 아이템 렌더 함수: ({ item, index }) => ReactNode (필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "루트 요소 스타일"
+            }
+          },
+          "required": [
+            "list"
+          ],
+          "additionalProperties": false,
+          "description": "데이터 리스트. list 상태에 따라 로딩/스켈레톤/빈 상태/데이터를 자동 처리. ErrorBoundary 내장."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "divider": {
+      "$ref": "#/definitions/dividerPropsSchema",
+      "definitions": {
+        "dividerPropsSchema": {
+          "type": "object",
+          "properties": {
+            "orientation": {
+              "type": "string",
+              "enum": [
+                "horizontal",
+                "vertical"
+              ],
+              "default": "horizontal",
+              "description": "방향"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "solid",
+                "dashed",
+                "dotted"
+              ],
+              "default": "solid",
+              "description": "선 스타일"
+            },
+            "color": {
+              "type": "string",
+              "description": "커스텀 색상 (CSS 값)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "구분선. 수평/수직 방향, 실선/점선/파선 지원."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "drawer": {
+      "$ref": "#/definitions/drawerPropsSchema",
+      "definitions": {
+        "drawerPropsSchema": {
+          "type": "object",
+          "properties": {
+            "direction": {
+              "type": "string",
+              "enum": [
+                "bottom",
+                "top",
+                "left",
+                "right"
+              ],
+              "default": "bottom",
+              "description": "방향"
+            },
+            "children": {
+              "description": "Drawer 하위 컴포넌트 (ReactNode)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "드로어/바텀시트. Vaul 기반. 합성 컴포넌트 패턴."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "drawerContent": {
+      "$ref": "#/definitions/drawerContentPropsSchema",
+      "definitions": {
+        "drawerContentPropsSchema": {
+          "type": "object",
+          "properties": {
+            "direction": {
+              "type": "string",
+              "enum": [
+                "bottom",
+                "top",
+                "left",
+                "right"
+              ],
+              "default": "bottom",
+              "description": "방향 (Context 우선)"
+            },
+            "blur": {
+              "type": "string",
+              "enum": [
+                "none",
+                "sm",
+                "md"
+              ],
+              "default": "none",
+              "description": "오버레이 블러"
+            },
+            "showHandle": {
+              "type": "boolean",
+              "default": true,
+              "description": "핸들 바 표시"
+            },
+            "children": {
+              "description": "컨텐츠 영역 (ReactNode)"
+            },
+            "overlayClassName": {
+              "type": "string",
+              "description": "오버레이 스타일"
+            },
+            "className": {
+              "type": "string",
+              "description": "패널 스타일"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Drawer.Content 영역."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "ellipsis": {
+      "$ref": "#/definitions/ellipsisPropsSchema",
+      "definitions": {
+        "ellipsisPropsSchema": {
+          "type": "object",
+          "properties": {
+            "content": {
+              "default": "",
+              "description": "본문 (ReactNode)"
+            },
+            "lineClamp": {
+              "type": "number",
+              "default": 2,
+              "description": "줄 수 제한"
+            },
+            "triggerMore": {
+              "default": "more",
+              "description": "더보기 텍스트 (ReactNode)"
+            },
+            "triggerLess": {
+              "default": "less",
+              "description": "접기 텍스트 (ReactNode)"
+            },
+            "defaultShortened": {
+              "type": "boolean",
+              "default": true,
+              "description": "초기 접힘 상태"
+            },
+            "observingEnvs": {
+              "type": "array",
+              "items": {
+                "type": "boolean"
+              },
+              "description": "외부 조건 변경 시 리사이즈 재측정"
+            },
+            "onShowMoreLessClick": {
+              "description": "더보기/접기 클릭 콜백 () => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "텍스트 말줄임. 더보기/접기 토글 내장."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "errorBoundary": {
+      "$ref": "#/definitions/errorBoundaryPropsSchema",
+      "definitions": {
+        "errorBoundaryPropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "감싸질 자식 요소 (ReactNode, 필수)"
+            },
+            "fallback": {
+              "description": "에러 발생 시 대체 UI (ReactNode)"
+            },
+            "onError": {
+              "description": "에러 발생 콜백 (error: Error, errorInfo: ErrorInfo) => void"
+            }
+          },
+          "additionalProperties": false,
+          "description": "에러 경계. 하위 컴포넌트 렌더링 에러를 잡아 fallback UI 표시."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "infiniteScroll": {
+      "$ref": "#/definitions/infiniteScrollPropsSchema",
+      "definitions": {
+        "infiniteScrollPropsSchema": {
+          "type": "object",
+          "properties": {
+            "list": {
+              "anyOf": [
+                {
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "현재 데이터 배열 (필수)"
+            },
+            "totalCount": {
+              "type": "number",
+              "description": "전체 개수 (hasMore와 배타적 사용)"
+            },
+            "hasMore": {
+              "type": "boolean",
+              "description": "더 있는지 (totalCount와 배타적 사용)"
+            },
+            "tag": {
+              "type": "string",
+              "default": "div",
+              "description": "children 래퍼 태그"
+            },
+            "rootMargin": {
+              "type": "number",
+              "default": 100,
+              "description": "감지 마진 (px)"
+            },
+            "loading": {
+              "type": "boolean",
+              "description": "로딩 상태"
+            },
+            "loadingElement": {
+              "description": "커스텀 로딩 요소"
+            },
+            "handleLoadMore": {
+              "description": "추가 로딩 콜백 () => void, 필수"
+            },
+            "scrollTarget": {
+              "description": "스크롤 대상 요소 (HTMLElement | Document | MutableRefObject)"
+            },
+            "children": {
+              "description": "리스트 아이템 렌더링 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "required": [
+            "list"
+          ],
+          "additionalProperties": false,
+          "description": "무한 스크롤. IntersectionObserver 기반."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "marquee": {
+      "$ref": "#/definitions/marqueePropsSchema",
+      "definitions": {
+        "marqueePropsSchema": {
+          "type": "object",
+          "properties": {
+            "direction": {
+              "type": "string",
+              "enum": [
+                "left",
+                "right",
+                "up",
+                "down"
+              ],
+              "default": "left",
+              "description": "방향"
+            },
+            "speed": {
+              "type": "number",
+              "default": 40,
+              "description": "애니메이션 속도 (초)"
+            },
+            "pauseOnHover": {
+              "type": "boolean",
+              "default": false,
+              "description": "호버 시 일시정지"
+            },
+            "gap": {
+              "type": "number",
+              "default": 16,
+              "description": "아이템 간격 (px)"
+            },
+            "children": {
+              "description": "반복 표시할 콘텐츠 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "마퀴 (흐르는 텍스트/요소)."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "modalTemplate": {
+      "$ref": "#/definitions/modalTemplatePropsSchema",
+      "definitions": {
+        "modalTemplatePropsSchema": {
+          "type": "object",
+          "properties": {
+            "title": {
+              "description": "헤더 제목 (ReactNode)"
+            },
+            "desc": {
+              "description": "헤더 설명 (ReactNode)"
+            },
+            "layout": {
+              "type": "string",
+              "enum": [
+                "default",
+                "bottom-sheet",
+                "slide-left",
+                "slide-right",
+                "full-page",
+                "full-page-reverse",
+                "draggable"
+              ],
+              "default": "default",
+              "description": "레이아웃"
+            },
+            "showDim": {
+              "type": "boolean",
+              "default": true,
+              "description": "딤 배경 표시"
+            },
+            "dimClose": {
+              "type": "boolean",
+              "default": true,
+              "description": "딤 클릭 시 닫기"
+            },
+            "hideHeader": {
+              "type": "boolean",
+              "default": false,
+              "description": "헤더 숨김"
+            },
+            "hideFooter": {
+              "type": "boolean",
+              "default": true,
+              "description": "푸터 숨김"
+            },
+            "footer": {
+              "description": "커스텀 푸터 (ReactElement)"
+            },
+            "animation": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "애니메이션 이름"
+                },
+                "mobile": {
+                  "type": "string",
+                  "description": "모바일용 애니메이션 이름"
+                },
+                "delay": {
+                  "type": "number",
+                  "description": "지연 (ms)"
+                },
+                "duration": {
+                  "type": "number",
+                  "description": "지속 시간 (ms)"
+                },
+                "timingFunc": {
+                  "type": "string",
+                  "description": "타이밍 함수"
+                },
+                "leaveTimingFunc": {
+                  "type": "string",
+                  "description": "퇴장 타이밍 함수"
+                }
+              },
+              "additionalProperties": false,
+              "description": "모달 애니메이션 (ModalTemplatePropsType)"
+            },
+            "enableDrag": {
+              "type": "boolean",
+              "default": true,
+              "description": "드래그 활성화 (바텀시트·드래그 가능 레이아웃)"
+            },
+            "dragPersistKey": {
+              "type": "string",
+              "description": "드래그 위치 저장 키"
+            },
+            "children": {
+              "description": "모달 본문 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "루트 래퍼 스타일"
+            },
+            "innerClassName": {
+              "type": "string",
+              "description": "모달 본체 스타일"
+            },
+            "bodyClassName": {
+              "type": "string",
+              "description": "바디 영역 스타일"
+            },
+            "footerClassName": {
+              "type": "string",
+              "description": "푸터 영역 스타일"
+            },
+            "dimClassName": {
+              "type": "string",
+              "description": "딤 배경 스타일"
+            },
+            "headerClassName": {
+              "type": "string",
+              "description": "헤더 영역 스타일"
+            }
+          },
+          "additionalProperties": false,
+          "description": "모달 템플릿. 모든 모달 컴포넌트는 반드시 ModalTemplate으로 감싸야 한다."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "modalCall": {
+      "$ref": "#/definitions/modalCallSchema",
+      "definitions": {
+        "modalCallSchema": {
+          "type": "object",
+          "properties": {
+            "component": {
+              "description": "모달 컴포넌트 (필수)"
+            },
+            "props": {
+              "type": "object",
+              "additionalProperties": {},
+              "description": "컴포넌트에 전달할 props"
+            }
+          },
+          "additionalProperties": false,
+          "description": "modal() 함수 호출 형태. component는 close/resolve를 자동으로 props로 받는다."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "numberInput": {
+      "$ref": "#/definitions/numberInputPropsSchema",
+      "definitions": {
+        "numberInputPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": [
+                "number",
+                "string"
+              ],
+              "description": "현재 값"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "error": {
+              "type": "boolean",
+              "description": "에러 상태"
+            },
+            "min": {
+              "type": "number",
+              "description": "최소값"
+            },
+            "max": {
+              "type": "number",
+              "description": "최대값"
+            },
+            "step": {
+              "type": "number",
+              "default": 1,
+              "description": "증감 단위"
+            },
+            "digit": {
+              "type": "number",
+              "default": 0,
+              "description": "소수 자릿수"
+            },
+            "hideButtons": {
+              "type": "boolean",
+              "default": false,
+              "description": "기본 스핀 버튼 숨김. numberInputBind로 외부 버튼에 이벤트 부착 시 사용"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "readOnly": {
+              "type": "boolean",
+              "description": "읽기 전용. 입력·스핀 버튼으로 값 변경 불가(스핀 버튼은 숨김)"
+            },
+            "placeholder": {
+              "type": "string",
+              "description": "플레이스홀더"
+            },
+            "onValueChange": {
+              "description": "값 변경 콜백 (value: number | undefined) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "숫자 입력. 꾹 누르면 가속 증감. ref로 increment/decrement 메서드 노출. numberInputBind(ref, direction) 함수로 외부 버튼에 동일한 가속 이벤트 바인딩 가능."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "pagination": {
+      "$ref": "#/definitions/paginationPropsSchema",
+      "definitions": {
+        "paginationPropsSchema": {
+          "type": "object",
+          "properties": {
+            "currentPage": {
+              "type": "number",
+              "description": "현재 페이지 (1부터, 필수)"
+            },
+            "totalPages": {
+              "type": "number",
+              "description": "전체 페이지 수 (필수)"
+            },
+            "siblingCount": {
+              "type": "number",
+              "default": 1,
+              "description": "현재 페이지 양옆 표시 개수"
+            },
+            "showEdges": {
+              "type": "boolean",
+              "description": "첫/끝 페이지 항상 표시"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "onPageChange": {
+              "description": "페이지 변경 콜백 (page: number) => void, 필수"
+            },
+            "className": {
+              "type": "string",
+              "description": "<nav> 스타일"
+            }
+          },
+          "required": [
+            "currentPage",
+            "totalPages"
+          ],
+          "additionalProperties": false,
+          "description": "페이지네이션. 이전/다음 + 번호 버튼."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "popover": {
+      "$ref": "#/definitions/popoverPropsSchema",
+      "definitions": {
+        "popoverPropsSchema": {
+          "type": "object",
+          "properties": {
+            "trigger": {
+              "description": "트리거 요소 (ReactNode, 필수)"
+            },
+            "side": {
+              "type": "string",
+              "enum": [
+                "top",
+                "right",
+                "bottom",
+                "left"
+              ],
+              "default": "bottom",
+              "description": "위치"
+            },
+            "align": {
+              "type": "string",
+              "enum": [
+                "start",
+                "center",
+                "end"
+              ],
+              "default": "center",
+              "description": "정렬"
+            },
+            "sideOffset": {
+              "type": "number",
+              "default": 4,
+              "description": "위치 오프셋 (px)"
+            },
+            "alignOffset": {
+              "type": "number",
+              "description": "정렬 오프셋 (px)"
+            },
+            "open": {
+              "type": "boolean",
+              "description": "제어 모드"
+            },
+            "onOpenChange": {
+              "description": "열림/닫힘 상태 변경 콜백 (open: boolean) => void"
+            },
+            "onClickTrigger": {
+              "description": "트리거 요소 클릭 시 호출되는 콜백. PopoverPrimitive.Trigger의 onClick에 전달됨."
+            },
+            "children": {
+              "description": "팝오버 본문 (ReactNode)"
+            },
+            "className": {
+              "type": "string",
+              "description": "Content 스타일"
+            },
+            "arrowClassName": {
+              "type": "string",
+              "description": "Arrow 스타일"
+            }
+          },
+          "additionalProperties": false,
+          "description": "팝오버. Radix Popover 기반."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "radioGroup": {
+      "$ref": "#/definitions/radioGroupPropsSchema",
+      "definitions": {
+        "radioGroupPropsSchema": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "form name (필수)"
+            },
+            "value": {
+              "type": "string",
+              "description": "선택된 값 (제어)"
+            },
+            "defaultValue": {
+              "type": "string",
+              "description": "초기값 (비제어)"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "orientation": {
+              "type": "string",
+              "enum": [
+                "horizontal",
+                "vertical"
+              ],
+              "default": "vertical",
+              "description": "배치 방향"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "aria-label": {
+              "type": "string",
+              "description": "접근성 라벨"
+            },
+            "onValueChange": {
+              "description": "값 변경 콜백 (value: string) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "required": [
+            "name"
+          ],
+          "additionalProperties": false,
+          "description": "라디오 그룹. RadioItem과 함께 사용."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "radioItem": {
+      "$ref": "#/definitions/radioItemPropsSchema",
+      "definitions": {
+        "radioItemPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "string",
+              "description": "항목 값 (필수)"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "description": "크기 (그룹보다 우선)"
+            },
+            "label": {
+              "description": "라벨 텍스트 (ReactNode)"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false,
+          "description": "RadioGroup 내 개별 옵션."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "select": {
+      "$ref": "#/definitions/selectPropsSchema",
+      "definitions": {
+        "selectPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "string",
+              "description": "선택된 값"
+            },
+            "placeholder": {
+              "type": "string",
+              "description": "플레이스홀더"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "default",
+                "outline"
+              ],
+              "default": "default",
+              "description": "트리거 스타일"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg",
+                "full"
+              ],
+              "default": "full",
+              "description": "너비"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "onValueChange": {
+              "description": "값 변경 콜백 (value: string) => void"
+            },
+            "displayComponent": {
+              "description": "트리거에 커스텀 표시 (ReactNode)"
+            },
+            "children": {
+              "description": "SelectItem 목록 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "래퍼 스타일"
+            },
+            "triggerClassName": {
+              "type": "string",
+              "description": "트리거 스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "드롭다운 선택. Radix Select 기반. SelectItem과 함께 사용."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "selectItem": {
+      "$ref": "#/definitions/selectItemPropsSchema",
+      "definitions": {
+        "selectItemPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "string",
+              "description": "항목 값"
+            },
+            "children": {
+              "description": "항목 내용 (ReactNode, 필수)"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "required": [
+            "value"
+          ],
+          "additionalProperties": false,
+          "description": "Select 내 개별 옵션."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "skeleton": {
+      "$ref": "#/definitions/skeletonPropsSchema",
+      "definitions": {
+        "skeletonPropsSchema": {
+          "type": "object",
+          "properties": {
+            "as": {
+              "type": "string",
+              "enum": [
+                "div",
+                "span"
+              ],
+              "default": "div",
+              "description": "렌더링 태그"
+            },
+            "circle": {
+              "type": "boolean",
+              "default": false,
+              "description": "원형 스켈레톤 (rounded-full)"
+            },
+            "width": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "너비 (예: '100px', '50%', 200)"
+            },
+            "height": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "높이 (예: '16px', 40)"
+            },
+            "children": {
+              "description": "내부 콘텐츠 (로딩 완료 시 표시, 실제 크기 유지용)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "스켈레톤 로딩 플레이스홀더. className으로 크기/모양 조절. children이 있으면 투명하게 감싸서 실제 크기 유지."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "spinner": {
+      "$ref": "#/definitions/spinnerPropsSchema",
+      "definitions": {
+        "spinnerPropsSchema": {
+          "type": "object",
+          "properties": {
+            "size": {
+              "type": "number",
+              "default": 20,
+              "description": "px 크기"
+            },
+            "aria-label": {
+              "type": "string",
+              "default": "Loading",
+              "description": "접근성 라벨"
+            },
+            "className": {
+              "type": "string",
+              "description": "색상 등 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "로딩 인디케이터. SVG 기반. role=\"status\" 내장."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "switch": {
+      "$ref": "#/definitions/switchPropsSchema",
+      "definitions": {
+        "switchPropsSchema": {
+          "type": "object",
+          "properties": {
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "checked": {
+              "type": "boolean",
+              "description": "on/off 상태"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "readOnly": {
+              "type": "boolean",
+              "description": "읽기 전용. 네이티브 input readOnly와 동일하게 on/off 상태 변경 불가"
+            },
+            "onCheckedChange": {
+              "description": "토글 상태 변경 콜백 (checked: boolean) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "토글 스위치. 네이티브 checkbox 기반, role=\"switch\"."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "tab": {
+      "$ref": "#/definitions/tabPropsSchema",
+      "definitions": {
+        "tabPropsSchema": {
+          "type": "object",
+          "properties": {
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "key": {
+                    "type": "string",
+                    "description": "탭 고유 키"
+                  },
+                  "label": {
+                    "description": "탭 라벨 (ReactNode)"
+                  },
+                  "children": {
+                    "description": "탭 패널 내용 (ReactNode)"
+                  },
+                  "disabled": {
+                    "type": "boolean",
+                    "description": "비활성"
+                  }
+                },
+                "required": [
+                  "key"
+                ],
+                "additionalProperties": false
+              },
+              "description": "탭 항목 배열 (필수)"
+            },
+            "activeKey": {
+              "type": "string",
+              "description": "제어 모드 활성 키"
+            },
+            "defaultActiveKey": {
+              "type": "string",
+              "description": "비제어 초기 키"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "line",
+                "pill"
+              ],
+              "default": "line",
+              "description": "스타일"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "destroyInactive": {
+              "type": "boolean",
+              "default": false,
+              "description": "비활성 패널 언마운트"
+            },
+            "onTabChange": {
+              "description": "탭 변경 콜백 (key: string) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "루트 스타일"
+            },
+            "tabListClassName": {
+              "type": "string",
+              "description": "탭 리스트 스타일"
+            },
+            "tabPanelClassName": {
+              "type": "string",
+              "description": "탭 패널 스타일"
+            }
+          },
+          "required": [
+            "items"
+          ],
+          "additionalProperties": false,
+          "description": "탭 네비게이션. line/pill 변형."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "table": {
+      "$ref": "#/definitions/tablePropsSchema",
+      "definitions": {
+        "tablePropsSchema": {
+          "type": "object",
+          "properties": {
+            "list": {
+              "anyOf": [
+                {
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "데이터 배열. null/undefined이면 로딩 상태 (필수)"
+            },
+            "children": {
+              "description": "행 렌더 함수 ({ item, index }) => ReactNode (필수)"
+            },
+            "hideThead": {
+              "type": "boolean",
+              "description": "테이블 헤더 숨김"
+            },
+            "loading": {
+              "type": "boolean",
+              "description": "로딩 상태 강제"
+            },
+            "loadingType": {
+              "type": "string",
+              "enum": [
+                "loading",
+                "skeleton"
+              ],
+              "default": "skeleton",
+              "description": "로딩 표시 방식"
+            },
+            "loadingElement": {
+              "description": "커스텀 로딩 요소 (ReactElement)"
+            },
+            "skeletonCount": {
+              "type": "number",
+              "default": 10,
+              "description": "스켈레톤 행 수"
+            },
+            "noDataMsg": {
+              "description": "데이터 없을 때 메시지 (ReactElement | string)"
+            },
+            "notification": {
+              "description": "테이블 상단 알림 영역 (ReactNode)"
+            },
+            "sortUpElement": {
+              "description": "오름차순 정렬 아이콘 (ReactElement)"
+            },
+            "sortDownElement": {
+              "description": "내림차순 정렬 아이콘 (ReactElement)"
+            },
+            "className": {
+              "type": "string",
+              "description": "테이블 래퍼 스타일"
+            },
+            "theadClassName": {
+              "type": "string",
+              "description": "헤더 행 스타일"
+            }
+          },
+          "required": [
+            "list"
+          ],
+          "additionalProperties": false,
+          "description": "테이블. TdColumn으로 컬럼 정의, TableRow로 행 래핑. 정렬/스켈레톤 로딩 내장."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "tableRow": {
+      "$ref": "#/definitions/tableRowPropsSchema",
+      "definitions": {
+        "tableRowPropsSchema": {
+          "type": "object",
+          "properties": {
+            "variant": {
+              "type": "string",
+              "enum": [
+                "default",
+                "accent"
+              ],
+              "default": "default",
+              "description": "행 스타일"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            },
+            "children": {
+              "description": "TdColumn 목록 (ReactNode, 필수)"
+            },
+            "onClick": {
+              "description": "행 클릭 콜백 (e: MouseEvent) => void"
+            }
+          },
+          "additionalProperties": false,
+          "description": "테이블 행. Table 내부에서 사용."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "tdColumn": {
+      "$ref": "#/definitions/tdColumnPropsSchema",
+      "definitions": {
+        "tdColumnPropsSchema": {
+          "type": "object",
+          "properties": {
+            "label": {
+              "description": "헤더 라벨 (ReactElement | string)"
+            },
+            "fieldId": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "컬럼 식별자 (정렬 키, 필수)"
+            },
+            "size": {
+              "type": [
+                "number",
+                "string"
+              ],
+              "description": "컬럼 너비 (number → px, string → CSS값)"
+            },
+            "align": {
+              "type": "string",
+              "enum": [
+                "left",
+                "center",
+                "right"
+              ],
+              "default": "left",
+              "description": "텍스트 정렬"
+            },
+            "textOverflow": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "truncate",
+                "wrap",
+                "break-all"
+              ],
+              "default": "truncate",
+              "description": "텍스트 넘침 처리"
+            },
+            "highlightKey": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "description": "호버 하이라이트 그룹 키"
+            },
+            "colSpan": {
+              "type": "number",
+              "description": "열 병합"
+            },
+            "rowSpan": {
+              "type": "number",
+              "description": "행 병합"
+            },
+            "thColSpan": {
+              "type": "number",
+              "description": "헤더 colSpan (<th>)"
+            },
+            "thRowSpan": {
+              "type": "number",
+              "description": "헤더 rowSpan (<th>)"
+            },
+            "enableSorting": {
+              "type": "boolean",
+              "description": "정렬 활성화"
+            },
+            "order": {
+              "type": "string",
+              "enum": [
+                "desc",
+                "asc",
+                ""
+              ],
+              "description": "현재 정렬 방향"
+            },
+            "sortValue": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "정렬 기준 값"
+            },
+            "handleClickSort": {
+              "description": "정렬 클릭 콜백 ({ index, fieldId, order }) => void"
+            },
+            "children": {
+              "description": "셀 내용 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "required": [
+            "fieldId"
+          ],
+          "additionalProperties": false,
+          "description": "테이블 셀/컬럼 정의. TableRow 내부에서 사용."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "textArea": {
+      "$ref": "#/definitions/textAreaPropsSchema",
+      "definitions": {
+        "textAreaPropsSchema": {
+          "type": "object",
+          "properties": {
+            "error": {
+              "type": "boolean",
+              "description": "에러 상태 (aria-invalid 자동)"
+            },
+            "showCount": {
+              "type": "boolean",
+              "description": "글자 수 표시 (maxLength 필요)"
+            },
+            "maxLength": {
+              "type": "number",
+              "description": "최대 글자 수"
+            },
+            "placeholder": {
+              "type": "string",
+              "description": "플레이스홀더"
+            },
+            "rows": {
+              "type": "number",
+              "description": "표시 줄 수"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "onValueChange": {
+              "description": "값 변경 콜백 (value: string) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "여러 줄 텍스트 입력. 글자 수 카운터 내장."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "textInput": {
+      "$ref": "#/definitions/textInputPropsSchema",
+      "definitions": {
+        "textInputPropsSchema": {
+          "type": "object",
+          "properties": {
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg",
+                "xl"
+              ],
+              "default": "md",
+              "description": "크기"
+            },
+            "error": {
+              "type": "boolean",
+              "description": "에러 상태 (aria-invalid 자동)"
+            },
+            "prefixIcon": {
+              "description": "앞쪽 아이콘 (ReactNode)"
+            },
+            "suffixIcon": {
+              "description": "뒤쪽 아이콘 (ReactNode)"
+            },
+            "label": {
+              "description": "입력 필드 위 라벨 (ReactNode)"
+            },
+            "description": {
+              "description": "입력 필드 아래 설명 텍스트 (ReactNode, error 시 빨간색)"
+            },
+            "showCount": {
+              "type": "boolean",
+              "description": "글자 수 카운트 표시 (maxLength 필요)"
+            },
+            "maxLength": {
+              "type": "number",
+              "description": "최대 글자 수"
+            },
+            "clearable": {
+              "type": "boolean",
+              "description": "X 버튼으로 입력값 초기화"
+            },
+            "placeholder": {
+              "type": "string",
+              "description": "플레이스홀더"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "비활성"
+            },
+            "onValueChange": {
+              "description": "값 변경 콜백 (value: string) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "텍스트 입력 필드. label, description, prefix/suffix 아이콘, clearable, 글자 수 카운트 지원."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "themeProvider": {
+      "$ref": "#/definitions/themeProviderPropsSchema",
+      "definitions": {
+        "themeProviderPropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "앱 루트 요소 (ReactNode, 필수)"
+            },
+            "defaultTheme": {
+              "type": "string",
+              "description": "기본 테마 (예: \"dark\", \"light\")"
+            },
+            "storageKey": {
+              "type": "string",
+              "description": "localStorage 저장 키 (기본: \"theme\")"
+            },
+            "themes": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "사용 가능한 테마 목록 (기본: [\"light\", \"dark\"])"
+            },
+            "attribute": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ],
+              "description": "테마 적용 HTML 속성 (기본: \"data-theme\")"
+            },
+            "enableSystem": {
+              "type": "boolean",
+              "description": "시스템 테마 감지 활성화"
+            },
+            "disableTransitionOnChange": {
+              "type": "boolean",
+              "description": "테마 전환 시 트랜지션 비활성화"
+            },
+            "forcedTheme": {
+              "type": "string",
+              "description": "강제 테마 (사용자 변경 불가)"
+            },
+            "enableColorScheme": {
+              "type": "boolean",
+              "description": "color-scheme CSS 속성 자동 설정"
+            },
+            "nonce": {
+              "type": "string",
+              "description": "CSP nonce"
+            }
+          },
+          "additionalProperties": false,
+          "description": "테마 제공자. next-themes 기반. useTheme() 훅으로 테마 상태 접근."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "toaster": {
+      "$ref": "#/definitions/toasterPropsSchema",
+      "definitions": {
+        "toasterPropsSchema": {
+          "type": "object",
+          "properties": {
+            "position": {
+              "type": "string",
+              "enum": [
+                "top-left",
+                "top-center",
+                "top-right",
+                "bottom-left",
+                "bottom-center",
+                "bottom-right"
+              ],
+              "default": "top-center",
+              "description": "토스트 위치"
+            },
+            "unstyled": {
+              "type": "boolean",
+              "default": false,
+              "description": "기본 스타일 제거 (커스텀 스타일링 시)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Toaster 설정. 앱 루트에 한 번 배치. toast() 함수로 알림 표시. sonner 기반."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "tooltip": {
+      "$ref": "#/definitions/tooltipPropsSchema",
+      "definitions": {
+        "tooltipPropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "트리거 요소 (ReactNode, 필수)"
+            },
+            "content": {
+              "description": "툴팁 내용 (ReactNode, 필수)"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "dark",
+                "light"
+              ],
+              "default": "dark",
+              "description": "스타일"
+            },
+            "side": {
+              "type": "string",
+              "enum": [
+                "top",
+                "right",
+                "bottom",
+                "left"
+              ],
+              "default": "top",
+              "description": "위치"
+            },
+            "align": {
+              "type": "string",
+              "enum": [
+                "start",
+                "center",
+                "end"
+              ],
+              "default": "center",
+              "description": "정렬"
+            },
+            "delayDuration": {
+              "type": "number",
+              "default": 200,
+              "description": "표시 지연 (ms)"
+            },
+            "disabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "비활성"
+            },
+            "className": {
+              "type": "string",
+              "description": "Content 스타일"
+            },
+            "triggerClassName": {
+              "type": "string",
+              "description": "Trigger 스타일"
+            }
+          },
+          "additionalProperties": false,
+          "description": "툴팁. Radix Tooltip 기반. Provider 내장."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "virtualList": {
+      "$ref": "#/definitions/virtualListPropsSchema",
+      "definitions": {
+        "virtualListPropsSchema": {
+          "type": "object",
+          "properties": {
+            "items": {
+              "type": "array",
+              "description": "데이터 배열 (필수)"
+            },
+            "estimateSize": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {}
+              ],
+              "description": "예상 아이템 높이 (number 또는 함수, 필수)"
+            },
+            "renderItem": {
+              "description": "아이템 렌더러 (필수)"
+            },
+            "overscan": {
+              "type": "number",
+              "default": 5,
+              "description": "오버스캔 수"
+            },
+            "gap": {
+              "type": "number",
+              "default": 0,
+              "description": "아이템 간격 (px)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스크롤 컨테이너 스타일"
+            },
+            "endReachedThreshold": {
+              "type": "number",
+              "default": 200,
+              "description": "끝 감지 임계값 (px)"
+            },
+            "onEndReached": {
+              "description": "끝 도달 콜백 () => void"
+            }
+          },
+          "required": [
+            "items"
+          ],
+          "additionalProperties": false,
+          "description": "가상 스크롤 리스트. @tanstack/react-virtual 기반."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "virtualGrid": {
+      "$ref": "#/definitions/virtualGridPropsSchema",
+      "definitions": {
+        "virtualGridPropsSchema": {
+          "type": "object",
+          "properties": {
+            "items": {
+              "type": "array",
+              "description": "데이터 배열 (필수)"
+            },
+            "estimateSize": {
+              "anyOf": [
+                {
+                  "type": "number"
+                },
+                {}
+              ],
+              "description": "예상 아이템 높이 (필수)"
+            },
+            "columns": {
+              "type": "number",
+              "description": "열 수 (필수)"
+            },
+            "renderItem": {
+              "description": "아이템 렌더러 (필수)"
+            },
+            "overscan": {
+              "type": "number",
+              "default": 3,
+              "description": "오버스캔 수"
+            },
+            "gap": {
+              "type": "number",
+              "default": 0,
+              "description": "아이템 간격 (px)"
+            },
+            "endReachedThreshold": {
+              "type": "number",
+              "default": 200,
+              "description": "끝 감지 임계값 (px)"
+            },
+            "onEndReached": {
+              "description": "끝 도달 콜백 () => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "스크롤 컨테이너 스타일"
+            }
+          },
+          "required": [
+            "items",
+            "columns"
+          ],
+          "additionalProperties": false,
+          "description": "가상 스크롤 그리드. @tanstack/react-virtual 기반."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    }
+  }
+}