@nexus-cross/design-system 1.0.0 → 1.0.1

package/dist/schemas/_all.json

@@ -218,6 +218,24 @@
               "type": "boolean",
               "description": "비활성 (aria-disabled 자동)"
             },
+            "children": {
+              "description": "버튼 내용 (ReactNode)"
+            },
+            "onClick": {
+              "description": "클릭 이벤트 핸들러"
+            },
+            "type": {
+              "type": "string",
+              "enum": [
+                "button",
+                "submit",
+                "reset"
+              ],
+              "description": "HTML button type (기본: button)"
+            },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -356,14 +374,32 @@
             },
             "readOnly": {
               "type": "boolean",
-              "description": "읽기 전용. 네이티브 input readOnly와 동일하게 체크 상태 변경 불가"
+              "description": "읽기 전용"
             },
             "label": {
               "description": "라벨 텍스트 (ReactNode)"
             },
+            "children": {
+              "description": "라벨 대체 콘텐츠 (ReactNode)"
+            },
+            "name": {
+              "type": "string",
+              "description": "form 필드명"
+            },
+            "id": {
+              "type": "string",
+              "description": "요소 ID"
+            },
+            "value": {
+              "type": "string",
+              "description": "form 전송 시 값"
+            },
             "onCheckedChange": {
               "description": "체크 상태 변경 콜백 (checked: boolean) => void"
             },
+            "onChange": {
+              "description": "네이티브 change 이벤트 핸들러"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -410,8 +446,14 @@
               "type": "boolean",
               "description": "비활성 (aria-disabled 자동)"
             },
+            "children": {
+              "description": "칩 내용 (ReactNode)"
+            },
             "onClose": {
-              "description": "닫기 버튼 클릭 콜백 () => void"
+              "description": "닫기 버튼 클릭 콜백 (e: MouseEvent) => void. 전달 시 X 버튼 자동 표시"
+            },
+            "onClick": {
+              "description": "클릭 이벤트 핸들러"
             },
             "className": {
               "type": "string",
@@ -544,6 +586,9 @@
             "onEnd": {
               "description": "카운트 완료 콜백 () => void"
             },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -643,6 +688,9 @@
               "type": "string",
               "description": "커스텀 색상 (CSS 값)"
             },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -671,8 +719,27 @@
               "default": "bottom",
               "description": "방향"
             },
+            "open": {
+              "type": "boolean",
+              "description": "열림 상태 (제어 모드)"
+            },
+            "onOpenChange": {
+              "description": "열림 상태 변경 콜백 (open: boolean) => void"
+            },
+            "dismissible": {
+              "type": "boolean",
+              "description": "스와이프/외부 클릭으로 닫기 허용 (기본 true)"
+            },
+            "modal": {
+              "type": "boolean",
+              "description": "모달 모드 (기본 true). false면 배경과 상호작용 가능"
+            },
+            "shouldScaleBackground": {
+              "type": "boolean",
+              "description": "배경 축소 효과 (기본 false)"
+            },
             "children": {
-              "description": "Drawer 하위 컴포넌트 (ReactNode)"
+              "description": "Drawer 하위 컴포넌트 (ReactNode, 필수)"
             }
           },
           "additionalProperties": false,
@@ -731,6 +798,94 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "drawerTrigger": {
+      "$ref": "#/definitions/drawerTriggerPropsSchema",
+      "definitions": {
+        "drawerTriggerPropsSchema": {
+          "type": "object",
+          "properties": {
+            "asChild": {
+              "type": "boolean",
+              "description": "자식 요소로 렌더링"
+            },
+            "children": {
+              "description": "트리거 요소 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Drawer 열기 트리거."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "drawerClose": {
+      "$ref": "#/definitions/drawerClosePropsSchema",
+      "definitions": {
+        "drawerClosePropsSchema": {
+          "type": "object",
+          "properties": {
+            "asChild": {
+              "type": "boolean",
+              "description": "자식 요소로 렌더링"
+            },
+            "children": {
+              "description": "닫기 요소 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Drawer 닫기 버튼."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "drawerTitle": {
+      "$ref": "#/definitions/drawerTitlePropsSchema",
+      "definitions": {
+        "drawerTitlePropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "제목 텍스트 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Drawer 제목 (접근성용 필수)."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "drawerDescription": {
+      "$ref": "#/definitions/drawerDescriptionPropsSchema",
+      "definitions": {
+        "drawerDescriptionPropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "설명 텍스트 (ReactNode, 필수)"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Drawer 설명."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "ellipsis": {
       "$ref": "#/definitions/ellipsisPropsSchema",
       "definitions": {
@@ -902,6 +1057,9 @@
             "children": {
               "description": "반복 표시할 콘텐츠 (ReactNode, 필수)"
             },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -991,7 +1149,7 @@
                 }
               },
               "additionalProperties": false,
-              "description": "모달 애니메이션 (ModalTemplatePropsType)"
+              "description": "모달 애니메이션"
             },
             "enableDrag": {
               "type": "boolean",
@@ -1002,6 +1160,9 @@
               "type": "string",
               "description": "드래그 위치 저장 키"
             },
+            "close": {
+              "description": "모달 닫기 함수 (isAnimation?: boolean) => void (자동 주입)"
+            },
             "children": {
               "description": "모달 본문 (ReactNode, 필수)"
             },
@@ -1043,16 +1204,94 @@
           "type": "object",
           "properties": {
             "component": {
-              "description": "모달 컴포넌트 (필수)"
+              "description": "모달 컴포넌트 (필수). close/resolve를 자동으로 props로 받음"
             },
             "props": {
               "type": "object",
               "additionalProperties": {},
               "description": "컴포넌트에 전달할 props"
+            },
+            "id": {
+              "type": "string",
+              "description": "모달 ID (중복 체크 시 사용)"
+            },
+            "layout": {
+              "type": "string",
+              "enum": [
+                "default",
+                "bottom-sheet",
+                "slide-left",
+                "slide-right",
+                "full-page",
+                "full-page-reverse",
+                "draggable"
+              ],
+              "description": "레이아웃"
+            },
+            "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": "모달 애니메이션"
+            },
+            "scrollEnable": {
+              "type": "boolean",
+              "description": "배경 스크롤 허용"
+            },
+            "isToggle": {
+              "type": "boolean",
+              "description": "토글 모드 (같은 모달 재호출 시 닫기)"
+            },
+            "isAlone": {
+              "type": "boolean",
+              "description": "단독 모드 (기존 모달 모두 닫고 열기)"
+            },
+            "duplicateCheck": {
+              "type": "boolean",
+              "description": "동일 컴포넌트 중복 열기 방지"
+            },
+            "disableEscapeKeyPress": {
+              "type": "boolean",
+              "description": "ESC 키로 닫기 비활성화"
+            },
+            "componentName": {
+              "type": "string",
+              "description": "모달 식별 이름 (중복 체크, 모달 검색 시 사용)"
+            },
+            "onOpen": {
+              "description": "모달 열릴 때 콜백"
+            },
+            "onClose": {
+              "description": "모달 닫힐 때 콜백"
             }
           },
           "additionalProperties": false,
-          "description": "modal() 함수 호출 형태. component는 close/resolve를 자동으로 props로 받는다."
+          "description": "modal() 함수 호출 옵션. component는 close/resolve를 자동으로 props로 받는다."
         }
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
@@ -1114,15 +1353,33 @@
             },
             "readOnly": {
               "type": "boolean",
-              "description": "읽기 전용. 입력·스핀 버튼으로 값 변경 불가(스핀 버튼은 숨김)"
+              "description": "읽기 전용 (스핀 버튼 숨김 동작 포함)"
             },
             "placeholder": {
               "type": "string",
               "description": "플레이스홀더"
             },
+            "name": {
+              "type": "string",
+              "description": "form 필드명"
+            },
+            "id": {
+              "type": "string",
+              "description": "요소 ID"
+            },
+            "autoFocus": {
+              "type": "boolean",
+              "description": "자동 포커스"
+            },
             "onValueChange": {
               "description": "값 변경 콜백 (value: number | undefined) => void"
             },
+            "onBlur": {
+              "description": "포커스 해제 콜백"
+            },
+            "onFocus": {
+              "description": "포커스 콜백"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -1291,10 +1548,17 @@
               "type": "boolean",
               "description": "비활성"
             },
+            "children": {
+              "description": "RadioItem 목록 (ReactNode, 필수)"
+            },
             "aria-label": {
               "type": "string",
               "description": "접근성 라벨"
             },
+            "aria-labelledby": {
+              "type": "string",
+              "description": "접근성 라벨 참조 ID"
+            },
             "onValueChange": {
               "description": "값 변경 콜백 (value: string) => void"
             },
@@ -1333,9 +1597,16 @@
             "label": {
               "description": "라벨 텍스트 (ReactNode)"
             },
+            "children": {
+              "description": "라벨 대체 콘텐츠 (ReactNode)"
+            },
             "disabled": {
               "type": "boolean",
               "description": "비활성"
+            },
+            "className": {
+              "type": "string",
+              "description": "스타일 오버라이드"
             }
           },
           "required": [
@@ -1477,6 +1748,9 @@
             "children": {
               "description": "내부 콘텐츠 (로딩 완료 시 표시, 실제 크기 유지용)"
             },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -1499,11 +1773,18 @@
               "default": 20,
               "description": "px 크기"
             },
+            "color": {
+              "type": "string",
+              "description": "색상 (CSS color 값, 기본 currentColor)"
+            },
             "aria-label": {
               "type": "string",
               "default": "Loading",
               "description": "접근성 라벨"
             },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "className": {
               "type": "string",
               "description": "색상 등 오버라이드"
@@ -1540,11 +1821,22 @@
             },
             "readOnly": {
               "type": "boolean",
-              "description": "읽기 전용. 네이티브 input readOnly와 동일하게 on/off 상태 변경 불가"
+              "description": "읽기 전용"
+            },
+            "name": {
+              "type": "string",
+              "description": "form 필드명"
+            },
+            "id": {
+              "type": "string",
+              "description": "요소 ID"
             },
             "onCheckedChange": {
               "description": "토글 상태 변경 콜백 (checked: boolean) => void"
             },
+            "onChange": {
+              "description": "네이티브 change 이벤트 핸들러 (ChangeEvent)"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -1889,9 +2181,42 @@
               "type": "boolean",
               "description": "비활성"
             },
+            "readOnly": {
+              "type": "boolean",
+              "description": "읽기 전용"
+            },
+            "value": {
+              "type": "string",
+              "description": "입력값 (제어 모드)"
+            },
+            "defaultValue": {
+              "type": "string",
+              "description": "초기값 (비제어 모드)"
+            },
+            "name": {
+              "type": "string",
+              "description": "form 필드명"
+            },
+            "id": {
+              "type": "string",
+              "description": "요소 ID"
+            },
+            "autoFocus": {
+              "type": "boolean",
+              "description": "자동 포커스"
+            },
             "onValueChange": {
               "description": "값 변경 콜백 (value: string) => void"
             },
+            "onChange": {
+              "description": "네이티브 change 이벤트 핸들러"
+            },
+            "onBlur": {
+              "description": "포커스 해제 콜백"
+            },
+            "onFocus": {
+              "description": "포커스 콜백"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -1912,7 +2237,6 @@
             "size": {
               "type": "string",
               "enum": [
-                "sm",
                 "md",
                 "lg",
                 "xl"
@@ -1956,9 +2280,50 @@
               "type": "boolean",
               "description": "비활성"
             },
+            "readOnly": {
+              "type": "boolean",
+              "description": "읽기 전용"
+            },
+            "value": {
+              "type": "string",
+              "description": "입력값 (제어 모드)"
+            },
+            "defaultValue": {
+              "type": "string",
+              "description": "초기값 (비제어 모드)"
+            },
+            "type": {
+              "type": "string",
+              "description": "input type (text, password, email, url 등)"
+            },
+            "name": {
+              "type": "string",
+              "description": "form 필드명"
+            },
+            "id": {
+              "type": "string",
+              "description": "요소 ID (label htmlFor 연결용)"
+            },
+            "autoFocus": {
+              "type": "boolean",
+              "description": "자동 포커스"
+            },
+            "autoComplete": {
+              "type": "string",
+              "description": "자동완성 힌트 (on, off, email 등)"
+            },
             "onValueChange": {
               "description": "값 변경 콜백 (value: string) => void"
             },
+            "onChange": {
+              "description": "네이티브 change 이벤트 핸들러"
+            },
+            "onBlur": {
+              "description": "포커스 해제 콜백"
+            },
+            "onFocus": {
+              "description": "포커스 콜백"
+            },
             "className": {
               "type": "string",
               "description": "스타일 오버라이드"
@@ -2035,6 +2400,87 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "toastOptions": {
+      "$ref": "#/definitions/toastOptionsSchema",
+      "definitions": {
+        "toastOptionsSchema": {
+          "type": "object",
+          "properties": {
+            "description": {
+              "description": "토스트 부제목 (ReactNode)"
+            },
+            "duration": {
+              "type": "number",
+              "description": "자동 닫힘 시간 (ms). 기본 4000"
+            },
+            "icon": {
+              "description": "커스텀 아이콘 (ReactNode)"
+            },
+            "action": {
+              "description": "액션 버튼. { label: ReactNode, onClick: () => void }"
+            },
+            "cancel": {
+              "description": "취소 버튼. { label: ReactNode, onClick: () => void }"
+            },
+            "closeButton": {
+              "type": "boolean",
+              "description": "닫기(X) 버튼 표시"
+            },
+            "dismissible": {
+              "type": "boolean",
+              "description": "스와이프/클릭으로 닫기 가능 여부"
+            },
+            "richColors": {
+              "type": "boolean",
+              "description": "success/error/warning/info에 강한 색상 적용"
+            },
+            "invert": {
+              "type": "boolean",
+              "description": "색상 반전 (다크↔라이트)"
+            },
+            "position": {
+              "type": "string",
+              "enum": [
+                "top-left",
+                "top-center",
+                "top-right",
+                "bottom-left",
+                "bottom-center",
+                "bottom-right"
+              ],
+              "description": "이 토스트만 개별 위치 지정"
+            },
+            "onDismiss": {
+              "description": "닫힐 때 콜백 (toast: ToastT) => void"
+            },
+            "onAutoClose": {
+              "description": "자동 닫힘 시 콜백 (toast: ToastT) => void"
+            },
+            "className": {
+              "type": "string",
+              "description": "토스트 커스텀 클래스"
+            },
+            "style": {
+              "description": "토스트 인라인 스타일 (CSSProperties)"
+            },
+            "unstyled": {
+              "type": "boolean",
+              "description": "기본 스타일 제거 (커스텀 스타일링 시)"
+            },
+            "id": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "토스트 ID (중복 방지 또는 업데이트 시 사용)"
+            }
+          },
+          "additionalProperties": false,
+          "description": "toast() 호출 옵션. toast(message, options) 형태로 사용. toast.custom(jsx)으로 완전 커스텀 가능."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "toaster": {
       "$ref": "#/definitions/toasterPropsSchema",
       "definitions": {
@@ -2052,12 +2498,57 @@
                 "bottom-right"
               ],
               "default": "top-center",
-              "description": "토스트 위치"
+              "description": "토스트 기본 위치"
             },
             "unstyled": {
               "type": "boolean",
               "default": false,
               "description": "기본 스타일 제거 (커스텀 스타일링 시)"
+            },
+            "theme": {
+              "type": "string",
+              "enum": [
+                "light",
+                "dark",
+                "system"
+              ],
+              "description": "테마 설정"
+            },
+            "richColors": {
+              "type": "boolean",
+              "description": "success/error/warning/info에 강한 색상 적용"
+            },
+            "expand": {
+              "type": "boolean",
+              "description": "토스트를 항상 펼친 상태로 표시"
+            },
+            "duration": {
+              "type": "number",
+              "description": "전역 자동 닫힘 시간 (ms). 기본 4000"
+            },
+            "visibleToasts": {
+              "type": "number",
+              "description": "동시에 보이는 최대 토스트 수"
+            },
+            "closeButton": {
+              "type": "boolean",
+              "description": "모든 토스트에 닫기 버튼 표시"
+            },
+            "gap": {
+              "type": "number",
+              "description": "토스트 간 간격 (px)"
+            },
+            "offset": {
+              "description": "화면 가장자리로부터 간격. string | number | { top, right, bottom, left }"
+            },
+            "dir": {
+              "type": "string",
+              "enum": [
+                "ltr",
+                "rtl",
+                "auto"
+              ],
+              "description": "텍스트 방향"
             }
           },
           "additionalProperties": false,
@@ -2150,10 +2641,10 @@
                 },
                 {}
               ],
-              "description": "예상 아이템 높이 (number 또는 함수, 필수)"
+              "description": "예상 아이템 높이 (number 또는 (index) => number, 필수)"
             },
             "renderItem": {
-              "description": "아이템 렌더러 (필수)"
+              "description": "아이템 렌더러 (item, index, virtualItem) => ReactNode (필수)"
             },
             "overscan": {
               "type": "number",
@@ -2169,6 +2660,9 @@
               "type": "string",
               "description": "스크롤 컨테이너 스타일"
             },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "endReachedThreshold": {
               "type": "number",
               "default": 200,
@@ -2197,6 +2691,10 @@
               "type": "array",
               "description": "데이터 배열 (필수)"
             },
+            "columns": {
+              "type": "number",
+              "description": "열 수 (필수)"
+            },
             "estimateSize": {
               "anyOf": [
                 {
@@ -2206,12 +2704,8 @@
               ],
               "description": "예상 아이템 높이 (필수)"
             },
-            "columns": {
-              "type": "number",
-              "description": "열 수 (필수)"
-            },
             "renderItem": {
-              "description": "아이템 렌더러 (필수)"
+              "description": "아이템 렌더러 (item, index) => ReactNode (필수)"
             },
             "overscan": {
               "type": "number",
@@ -2223,6 +2717,13 @@
               "default": 0,
               "description": "아이템 간격 (px)"
             },
+            "className": {
+              "type": "string",
+              "description": "스크롤 컨테이너 스타일"
+            },
+            "style": {
+              "description": "인라인 스타일 (CSSProperties)"
+            },
             "endReachedThreshold": {
               "type": "number",
               "default": 200,
@@ -2230,10 +2731,6 @@
             },
             "onEndReached": {
               "description": "끝 도달 콜백 () => void"
-            },
-            "className": {
-              "type": "string",
-              "description": "스크롤 컨테이너 스타일"
             }
           },
           "required": [