@nexus-cross/design-system 1.0.0

package/dist/schemas/radioItem.json

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

package/dist/schemas/select.json

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

package/dist/schemas/selectItem.json

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

package/dist/schemas/skeleton.json

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

package/dist/schemas/spinner.json

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

package/dist/schemas/switch.json

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

package/dist/schemas/tab.json

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

package/dist/schemas/table.json

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

package/dist/schemas/tableRow.json

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

package/dist/schemas/tdColumn.json

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

package/dist/schemas/textArea.json

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

package/dist/schemas/textInput.json

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