@nexus-cross/design-system 1.0.0

package/dist/schemas/accordion.json

@@ -0,0 +1,101 @@
+{
+  "$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#"
+}

package/dist/schemas/avatar.json

@@ -0,0 +1,55 @@
+{
+  "$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#"
+}

package/dist/schemas/button.json

@@ -0,0 +1,71 @@
+{
+  "$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#"
+}

package/dist/schemas/carousel.json

@@ -0,0 +1,32 @@
+{
+  "$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#"
+}

package/dist/schemas/carouselButton.json

@@ -0,0 +1,20 @@
+{
+  "$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#"
+}

package/dist/schemas/carouselDots.json

@@ -0,0 +1,17 @@
+{
+  "$ref": "#/definitions/carouselDotsPropsSchema",
+  "definitions": {
+    "carouselDotsPropsSchema": {
+      "type": "object",
+      "properties": {
+        "className": {
+          "type": "string",
+          "description": "도트 컨테이너 스타일"
+        }
+      },
+      "additionalProperties": false,
+      "description": "CarouselDots. 슬라이드 인디케이터 도트."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/carouselSlide.json

@@ -0,0 +1,20 @@
+{
+  "$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#"
+}

package/dist/schemas/checkBox.json

@@ -0,0 +1,57 @@
+{
+  "$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#"
+}

package/dist/schemas/chip.json

@@ -0,0 +1,49 @@
+{
+  "$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#"
+}

package/dist/schemas/clientOnly.json

@@ -0,0 +1,19 @@
+{
+  "$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#"
+}

package/dist/schemas/countdown.json

@@ -0,0 +1,58 @@
+{
+  "$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#"
+}

package/dist/schemas/counter.json

@@ -0,0 +1,57 @@
+{
+  "$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#"
+}

package/dist/schemas/dataList.json

@@ -0,0 +1,56 @@
+{
+  "$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#"
+}

package/dist/schemas/divider.json

@@ -0,0 +1,40 @@
+{
+  "$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#"
+}