@nexus-cross/design-system 1.0.4-beta.1 → 1.0.4

package/dist/schemas/accordion.json

@@ -11,17 +11,17 @@
             "properties": {
               "id": {
                 "type": "string",
-                "description": "고유 ID"
+                "description": "Unique ID"
               },
               "trigger": {
-                "description": "트리거 내용 (ReactNode)"
+                "description": "Trigger content (ReactNode)"
               },
               "content": {
-                "description": "펼침 내용 (ReactNode)"
+                "description": "Expandable content (ReactNode)"
               },
               "disabled": {
                 "type": "boolean",
-                "description": "비활성"
+                "description": "Disabled"
               },
               "className": {
                 "type": "string"
@@ -38,7 +38,7 @@
             ],
             "additionalProperties": false
           },
-          "description": "아코디언 항목 배열 (필수)"
+          "description": "Accordion item array (required)"
         },
         "type": {
           "type": "string",
@@ -47,12 +47,12 @@
             "multiple"
           ],
           "default": "single",
-          "description": "단일/다중 열기"
+          "description": "Single/multiple open mode"
         },
         "collapsible": {
           "type": "boolean",
           "default": true,
-          "description": "전부 접기 가능"
+          "description": "Allow collapsing all"
         },
         "value": {
           "anyOf": [
@@ -66,7 +66,7 @@
               }
             }
           ],
-          "description": "제어 모드"
+          "description": "Controlled mode"
         },
         "defaultValue": {
           "anyOf": [
@@ -80,18 +80,21 @@
               }
             }
           ],
-          "description": "비제어 초기값"
+          "description": "Uncontrolled initial value"
+        },
+        "onValueChange": {
+          "description": "Open item change callback (value: string | string[]) => void"
         },
         "className": {
           "type": "string",
-          "description": "Root 스타일"
+          "description": "Root style"
         }
       },
       "required": [
         "items"
       ],
       "additionalProperties": false,
-      "description": "아코디언. items 배열 방식과 컴포저블 방식 모두 지원."
+      "description": "Accordion. Supports both items array and composable patterns."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/alert.json

@@ -0,0 +1,49 @@
+{
+  "$ref": "#/definitions/alertPropsSchema",
+  "definitions": {
+    "alertPropsSchema": {
+      "type": "object",
+      "properties": {
+        "variant": {
+          "type": "string",
+          "enum": [
+            "info",
+            "success",
+            "warning",
+            "danger"
+          ],
+          "default": "info",
+          "description": "Alert type / color"
+        },
+        "title": {
+          "type": "string",
+          "description": "Alert title (bold)"
+        },
+        "children": {
+          "description": "Alert description (ReactNode)"
+        },
+        "icon": {
+          "description": "Custom icon (ReactNode). Auto icon by variant if omitted"
+        },
+        "closable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Show close button"
+        },
+        "onClose": {
+          "description": "Close callback () => void"
+        },
+        "action": {
+          "description": "Action area (ReactNode, e.g. Button)"
+        },
+        "className": {
+          "type": "string",
+          "description": "Style override"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Alert / Banner. Inline notification with icon, title, description."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/avatar.json

@@ -6,14 +6,14 @@
       "properties": {
         "src": {
           "type": "string",
-          "description": "이미지 URL"
+          "description": "Image URL"
         },
         "alt": {
           "type": "string",
-          "description": "대체 텍스트"
+          "description": "Alt text"
         },
         "fallback": {
-          "description": "이미지 로드 실패 시 표시 (ReactNode)"
+          "description": "Displayed on image load failure (ReactNode)"
         },
         "size": {
           "type": "string",
@@ -25,7 +25,7 @@
             "xl"
           ],
           "default": "md",
-          "description": "크기"
+          "description": "Size"
         },
         "shape": {
           "type": "string",
@@ -34,15 +34,21 @@
             "square"
           ],
           "default": "circle",
-          "description": "형태"
+          "description": "Shape"
+        },
+        "children": {
+          "description": "Custom image element (e.g. Next.js Image)"
+        },
+        "onImageError": {
+          "description": "Image load error callback () => void"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "아바타. 이미지, 폴백 텍스트, children 지원."
+      "description": "Avatar. Supports image, fallback text, and children."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/badge.json

@@ -0,0 +1,76 @@
+{
+  "$ref": "#/definitions/badgePropsSchema",
+  "definitions": {
+    "badgePropsSchema": {
+      "type": "object",
+      "properties": {
+        "count": {
+          "type": "number",
+          "description": "Badge count number"
+        },
+        "max": {
+          "type": "number",
+          "default": 99,
+          "description": "Max count (shows \"99+\" when exceeded)"
+        },
+        "dot": {
+          "type": "boolean",
+          "default": false,
+          "description": "Show as dot instead of count"
+        },
+        "showZero": {
+          "type": "boolean",
+          "default": false,
+          "description": "Show badge when count is 0"
+        },
+        "variant": {
+          "type": "string",
+          "enum": [
+            "danger",
+            "primary",
+            "secondary",
+            "info",
+            "success",
+            "warning"
+          ],
+          "default": "danger",
+          "description": "Color variant"
+        },
+        "size": {
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "default": "md",
+          "description": "Size"
+        },
+        "offset": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "number"
+            }
+          ],
+          "description": "Position offset [x, y] in px"
+        },
+        "children": {
+          "description": "Anchor element to attach badge to (ReactNode)"
+        },
+        "className": {
+          "type": "string",
+          "description": "Style override"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Badge indicator. Dot or count display. Wraps children when provided."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/breadcrumb.json

@@ -0,0 +1,47 @@
+{
+  "$ref": "#/definitions/breadcrumbPropsSchema",
+  "definitions": {
+    "breadcrumbPropsSchema": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "description": "Display text or element (ReactNode)"
+              },
+              "href": {
+                "type": "string",
+                "description": "Link URL"
+              },
+              "onClick": {
+                "description": "Click handler () => void"
+              }
+            },
+            "additionalProperties": false
+          },
+          "description": "Breadcrumb items array (required)"
+        },
+        "separator": {
+          "description": "Custom separator (ReactNode). Default: chevron"
+        },
+        "maxItems": {
+          "type": "number",
+          "description": "Max visible items (collapses middle with \"...\")"
+        },
+        "className": {
+          "type": "string",
+          "description": "Style override"
+        }
+      },
+      "required": [
+        "items"
+      ],
+      "additionalProperties": false,
+      "description": "Breadcrumb navigation. Shows current location path."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/button.json

@@ -13,7 +13,7 @@
             "danger"
           ],
           "default": "primary",
-          "description": "색상 테마 (primary=주요, secondary=보조, normal=중립, danger=위험)"
+          "description": "Color theme (primary=main, secondary=sub, normal=neutral, danger=danger)"
         },
         "variant": {
           "type": "string",
@@ -24,7 +24,7 @@
             "ghost"
           ],
           "default": "contained",
-          "description": "시각 스타일 (contained=채움, outlined=테두리, subtle=연한배경, ghost=투명)"
+          "description": "Visual style (contained=filled, outlined=border, subtle=light bg, ghost=transparent)"
         },
         "size": {
           "type": "string",
@@ -35,7 +35,7 @@
             "sm"
           ],
           "default": "md",
-          "description": "크기"
+          "description": "Size"
         },
         "radius": {
           "type": "string",
@@ -44,27 +44,45 @@
             "circle"
           ],
           "default": "default",
-          "description": "모서리 (default=size별 radius, circle=pill 형태)"
+          "description": "Corner radius (default=size-based radius, circle=pill shape)"
         },
         "asChild": {
           "type": "boolean",
-          "description": "true면 자식 요소로 렌더링 (Slot 패턴)"
+          "description": "If true, renders as child element (Slot pattern)"
         },
         "detectDoubleClick": {
           "type": "boolean",
-          "description": "500ms 내 더블 클릭 방지"
+          "description": "Prevent double click within 500ms"
         },
         "disabled": {
           "type": "boolean",
-          "description": "비활성 (aria-disabled 자동)"
+          "description": "Disabled (auto aria-disabled)"
+        },
+        "children": {
+          "description": "Button content (ReactNode)"
+        },
+        "onClick": {
+          "description": "Click event handler"
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "button",
+            "submit",
+            "reset"
+          ],
+          "description": "HTML button type (default: button)"
+        },
+        "style": {
+          "description": "Inline style (CSSProperties)"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "인터랙티브 버튼. semantic(색상)×variant(스타일) 2축 시스템. asChild로 렌더링 요소 변경 가능."
+      "description": "Interactive button. semantic(color) x variant(style) 2-axis system. Rendering element changeable via asChild."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/carousel.json

@@ -7,19 +7,25 @@
         "opts": {
           "type": "object",
           "additionalProperties": {},
-          "description": "Embla 옵션 (loop, align 등)"
+          "description": "Embla options (loop, align, etc.)"
         },
         "plugins": {
           "type": "array",
-          "description": "Embla 플러그인"
+          "description": "Embla plugins"
+        },
+        "onApiChange": {
+          "description": "Embla API change callback (api: CarouselApi) => void"
+        },
+        "children": {
+          "description": "Carousel slides and sub-components (ReactNode)"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "캐러셀. Embla Carousel 기반. CarouselSlide, CarouselPrev, CarouselNext, CarouselDots 서브 컴포넌트."
+      "description": "Carousel. Based on Embla Carousel. Sub-components: 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": "Button style override"
+        },
+        "children": {
+          "description": "Custom icon (ReactNode, default: chevron)"
+        }
+      },
+      "additionalProperties": false,
+      "description": "CarouselPrev / CarouselNext. Previous/next navigation buttons."
+    }
+  },
+  "$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": "Dot container style"
+        }
+      },
+      "additionalProperties": false,
+      "description": "CarouselDots. Slide indicator dots."
+    }
+  },
+  "$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": "Slide style (use basis-1/3 etc. for multi-slide view)"
+        },
+        "children": {
+          "description": "Slide content (ReactNode, required)"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Carousel slide. Used inside Carousel."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/checkBox.json

@@ -11,7 +11,7 @@
             "md"
           ],
           "default": "md",
-          "description": "크기"
+          "description": "Size"
         },
         "shape": {
           "type": "string",
@@ -20,30 +20,55 @@
             "round"
           ],
           "default": "square",
-          "description": "형태"
+          "description": "Shape"
         },
         "checked": {
           "type": "boolean",
-          "description": "체크 상태"
+          "description": "Checked state"
         },
         "indeterminate": {
           "type": "boolean",
-          "description": "불확정 상태 (aria-checked=\"mixed\")"
+          "description": "Indeterminate state (aria-checked=\"mixed\")"
         },
         "disabled": {
           "type": "boolean",
-          "description": "비활성"
+          "description": "Disabled"
+        },
+        "readOnly": {
+          "type": "boolean",
+          "description": "Read-only"
         },
         "label": {
-          "description": "라벨 텍스트 (ReactNode)"
+          "description": "Label text (ReactNode)"
+        },
+        "children": {
+          "description": "Label alternative content (ReactNode)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Form field name"
+        },
+        "id": {
+          "type": "string",
+          "description": "Element ID"
+        },
+        "value": {
+          "type": "string",
+          "description": "Value for form submission"
+        },
+        "onCheckedChange": {
+          "description": "Checked state change callback (checked: boolean) => void"
+        },
+        "onChange": {
+          "description": "Native change event handler"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "체크박스. 네이티브 input 기반, square/round 형태 지원."
+      "description": "Checkbox. Native input-based, supports square/round shapes."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/chip.json

@@ -13,7 +13,7 @@
             "accent"
           ],
           "default": "default",
-          "description": "스타일"
+          "description": "Style"
         },
         "size": {
           "type": "string",
@@ -23,23 +23,32 @@
             "lg"
           ],
           "default": "md",
-          "description": "크기"
+          "description": "Size"
         },
         "asChild": {
           "type": "boolean",
-          "description": "true면 자식 요소로 렌더링 (Slot 패턴)"
+          "description": "If true, renders as child element (Slot pattern)"
         },
         "disabled": {
           "type": "boolean",
-          "description": "비활성 (aria-disabled 자동)"
+          "description": "Disabled (auto aria-disabled)"
+        },
+        "children": {
+          "description": "Chip content (ReactNode)"
+        },
+        "onClose": {
+          "description": "Close button click callback (e: MouseEvent) => void. Shows X button when provided"
+        },
+        "onClick": {
+          "description": "Click event handler"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "칩/태그/뱃지. onClose prop으로 닫기 버튼 표시."
+      "description": "Chip/tag/badge. Close button displayed via 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": "Element to render only on client (ReactNode, required)"
+        },
+        "fallback": {
+          "description": "Fallback UI during SSR (ReactNode, default: null)"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Client-only rendering. Prevents hydration mismatch in SSR environments."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/countdown.json

@@ -6,16 +6,16 @@
       "properties": {
         "endTimestamp": {
           "type": "number",
-          "description": "종료 시각 (Unix ms, 필수)"
+          "description": "End time (Unix ms, required)"
         },
         "separator": {
           "default": ":",
-          "description": "구분자 (ReactNode)"
+          "description": "Separator (ReactNode)"
         },
         "showDays": {
           "type": "boolean",
           "default": true,
-          "description": "일 단위 표시"
+          "description": "Show days unit"
         },
         "labels": {
           "type": "object",
@@ -34,21 +34,24 @@
             }
           },
           "additionalProperties": false,
-          "description": "단위 라벨"
+          "description": "Unit labels"
         },
         "render": {
-          "description": "커스텀 렌더 함수"
+          "description": "Custom render function"
+        },
+        "onEnd": {
+          "description": "Countdown end callback () => void"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "required": [
         "endTimestamp"
       ],
       "additionalProperties": false,
-      "description": "카운트다운 타이머."
+      "description": "Countdown timer."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"