@nexus-cross/design-system 1.0.6-beta.2 → 1.0.7

package/dist/schemas/_all.json

@@ -103,6 +103,55 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "alert": {
+      "$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#"
+    },
     "avatar": {
       "$ref": "#/definitions/avatarPropsSchema",
       "definitions": {
@@ -158,6 +207,129 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "badge": {
+      "$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#"
+    },
+    "breadcrumb": {
+      "$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#"
+    },
     "button": {
       "$ref": "#/definitions/buttonPropsSchema",
       "definitions": {
@@ -659,6 +831,62 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "datePicker": {
+      "$ref": "#/definitions/datePickerPropsSchema",
+      "definitions": {
+        "datePickerPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "description": "Controlled date value (Date)"
+            },
+            "defaultValue": {
+              "description": "Default date (Date)"
+            },
+            "onChange": {
+              "description": "Date change callback (date: Date | undefined) => void"
+            },
+            "placeholder": {
+              "type": "string",
+              "default": "날짜 선택",
+              "description": "Placeholder text"
+            },
+            "disabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Disabled"
+            },
+            "minDate": {
+              "description": "Minimum selectable date (Date)"
+            },
+            "maxDate": {
+              "description": "Maximum selectable date (Date)"
+            },
+            "locale": {
+              "type": "string",
+              "enum": [
+                "ko",
+                "en"
+              ],
+              "default": "ko",
+              "description": "Calendar locale"
+            },
+            "formatStr": {
+              "type": "string",
+              "default": "yyyy-MM-dd",
+              "description": "Date format string (date-fns format)"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "additionalProperties": false,
+          "description": "DatePicker. Calendar popup for date selection. Based on react-day-picker."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "divider": {
       "$ref": "#/definitions/dividerPropsSchema",
       "definitions": {
@@ -886,6 +1114,89 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "dropdownMenu": {
+      "$ref": "#/definitions/dropdownMenuPropsSchema",
+      "definitions": {
+        "dropdownMenuPropsSchema": {
+          "type": "object",
+          "properties": {
+            "children": {
+              "description": "Trigger element (ReactNode, required)"
+            },
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "description": "Menu item text (ReactNode)"
+                  },
+                  "value": {
+                    "type": "string",
+                    "description": "Item identifier"
+                  },
+                  "icon": {
+                    "description": "Left icon (ReactNode)"
+                  },
+                  "onClick": {
+                    "description": "Click handler () => void"
+                  },
+                  "disabled": {
+                    "type": "boolean",
+                    "description": "Disabled"
+                  },
+                  "danger": {
+                    "type": "boolean",
+                    "description": "Danger/destructive style"
+                  },
+                  "separator": {
+                    "type": "boolean",
+                    "description": "If true, renders as separator line"
+                  }
+                },
+                "additionalProperties": false
+              },
+              "description": "Menu items array (required)"
+            },
+            "align": {
+              "type": "string",
+              "enum": [
+                "start",
+                "center",
+                "end"
+              ],
+              "default": "start",
+              "description": "Alignment"
+            },
+            "side": {
+              "type": "string",
+              "enum": [
+                "top",
+                "right",
+                "bottom",
+                "left"
+              ],
+              "default": "bottom",
+              "description": "Position"
+            },
+            "className": {
+              "type": "string",
+              "description": "Trigger wrapper style"
+            },
+            "contentClassName": {
+              "type": "string",
+              "description": "Content panel style"
+            }
+          },
+          "required": [
+            "items"
+          ],
+          "additionalProperties": false,
+          "description": "Dropdown menu. Based on Radix DropdownMenu. Action menu for context/more menus."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "ellipsis": {
       "$ref": "#/definitions/ellipsisPropsSchema",
       "definitions": {
@@ -935,6 +1246,50 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "emptyState": {
+      "$ref": "#/definitions/emptyStatePropsSchema",
+      "definitions": {
+        "emptyStatePropsSchema": {
+          "type": "object",
+          "properties": {
+            "icon": {
+              "description": "Custom icon (ReactNode). Default inbox icon"
+            },
+            "title": {
+              "type": "string",
+              "description": "Title text"
+            },
+            "description": {
+              "type": "string",
+              "description": "Description text"
+            },
+            "action": {
+              "description": "Action area (ReactNode, e.g. Button)"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "Overall size"
+            },
+            "children": {
+              "description": "Additional content (ReactNode)"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Empty state placeholder. Shown when data is empty or unavailable."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "errorBoundary": {
       "$ref": "#/definitions/errorBoundaryPropsSchema",
       "definitions": {
@@ -1302,22 +1657,29 @@
         "numberInputPropsSchema": {
           "type": "object",
           "properties": {
-            "value": {
-              "type": [
-                "number",
-                "string"
+            "variant": {
+              "type": "string",
+              "enum": [
+                "basic",
+                "bind"
+              ],
+              "default": "basic",
+              "description": "Variant: basic (right chevron arrows) or bind (left/right +/- buttons)"
+            },
+            "value": {
+              "type": [
+                "number",
+                "string"
               ],
               "description": "Current value"
             },
             "size": {
               "type": "string",
               "enum": [
-                "sm",
-                "md",
                 "lg",
                 "xl"
               ],
-              "default": "md",
+              "default": "lg",
               "description": "Size"
             },
             "error": {
@@ -1330,7 +1692,7 @@
             },
             "max": {
               "type": "number",
-              "description": "Maximum value"
+              "description": "Maximum value. When set, \"Max {value}\" is displayed in the header. Clicking it fills the input with the max value"
             },
             "step": {
               "type": "number",
@@ -1342,10 +1704,22 @@
               "default": 0,
               "description": "Decimal places"
             },
+            "label": {
+              "type": "string",
+              "description": "Label text displayed above input"
+            },
+            "description": {
+              "type": "string",
+              "description": "Description text displayed below input"
+            },
+            "showMax": {
+              "type": "boolean",
+              "description": "Show \"Max {value}\" in header (defaults to true when max is set)"
+            },
             "hideButtons": {
               "type": "boolean",
               "default": false,
-              "description": "Hide default spin buttons. Use with numberInputBind for external button event binding"
+              "description": "Hide built-in buttons. Use with numberInputBind for external button event binding"
             },
             "disabled": {
               "type": "boolean",
@@ -1353,11 +1727,11 @@
             },
             "readOnly": {
               "type": "boolean",
-              "description": "Read-only (includes hiding spin buttons)"
+              "description": "Read-only (includes hiding buttons)"
             },
             "placeholder": {
               "type": "string",
-              "description": "Placeholder"
+              "description": "Placeholder (default: \"0\")"
             },
             "name": {
               "type": "string",
@@ -1386,7 +1760,63 @@
             }
           },
           "additionalProperties": false,
-          "description": "Number input. Accelerated increment on long press. Exposes increment/decrement methods via ref. numberInputBind(ref, direction) binds same acceleration to external buttons."
+          "description": "Number input with two variants: basic (chevron arrows) and bind (+/- buttons). Supports label, description, max display (click to fill), accelerated increment on long press. numberInputBind(ref, direction) binds acceleration to external buttons."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
+    "nxImage": {
+      "$ref": "#/definitions/nxImagePropsSchema",
+      "definitions": {
+        "nxImagePropsSchema": {
+          "type": "object",
+          "properties": {
+            "src": {
+              "type": "string",
+              "description": "Image source URL"
+            },
+            "alt": {
+              "type": "string",
+              "description": "Alt text"
+            },
+            "fallback": {
+              "description": "Custom fallback element (ReactNode)"
+            },
+            "fallbackSrc": {
+              "type": "string",
+              "description": "Fallback image URL on error"
+            },
+            "aspectRatio": {
+              "type": "string",
+              "description": "CSS aspect-ratio (e.g. \"16/9\", \"1/1\")"
+            },
+            "objectFit": {
+              "type": "string",
+              "enum": [
+                "cover",
+                "contain",
+                "fill",
+                "none"
+              ],
+              "default": "cover",
+              "description": "Object-fit mode"
+            },
+            "lazy": {
+              "type": "boolean",
+              "default": true,
+              "description": "Enable lazy loading (loading=\"lazy\")"
+            },
+            "wrapperClassName": {
+              "type": "string",
+              "description": "Wrapper div style"
+            },
+            "className": {
+              "type": "string",
+              "description": "Image element style"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Enhanced image. Lazy loading, fallback, aspect-ratio support."
         }
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
@@ -1612,6 +2042,69 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "progress": {
+      "$ref": "#/definitions/progressPropsSchema",
+      "definitions": {
+        "progressPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "number",
+              "default": 0,
+              "description": "Current progress value"
+            },
+            "max": {
+              "type": "number",
+              "default": 100,
+              "description": "Maximum value"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "primary",
+                "success",
+                "warning",
+                "danger",
+                "info"
+              ],
+              "default": "primary",
+              "description": "Color variant"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "Bar height"
+            },
+            "showValue": {
+              "type": "boolean",
+              "default": false,
+              "description": "Show percentage text"
+            },
+            "indeterminate": {
+              "type": "boolean",
+              "default": false,
+              "description": "Indeterminate loading animation"
+            },
+            "label": {
+              "type": "string",
+              "description": "Label text above the bar"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Progress bar. Linear progress indicator with percentage display."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "radioGroup": {
       "$ref": "#/definitions/radioGroupPropsSchema",
       "definitions": {
@@ -1866,6 +2359,84 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "slider": {
+      "$ref": "#/definitions/sliderPropsSchema",
+      "definitions": {
+        "sliderPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "Controlled value (number[]). Use [50] for single, [20, 80] for range"
+            },
+            "defaultValue": {
+              "type": "array",
+              "items": {
+                "type": "number"
+              },
+              "description": "Default value"
+            },
+            "min": {
+              "type": "number",
+              "default": 0,
+              "description": "Minimum"
+            },
+            "max": {
+              "type": "number",
+              "default": 100,
+              "description": "Maximum"
+            },
+            "step": {
+              "type": "number",
+              "default": 1,
+              "description": "Step increment"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "Track height / thumb size"
+            },
+            "showValue": {
+              "type": "boolean",
+              "default": false,
+              "description": "Show current value text"
+            },
+            "formatValue": {
+              "description": "Value format function (value: number) => string"
+            },
+            "label": {
+              "type": "string",
+              "description": "Label text"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "Disabled"
+            },
+            "onValueChange": {
+              "description": "Value change callback (value: number[]) => void"
+            },
+            "onValueCommit": {
+              "description": "Committed value callback (on pointer up)"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Slider / Range input. Based on Radix Slider. Supports single and range mode."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "spinner": {
       "$ref": "#/definitions/spinnerPropsSchema",
       "definitions": {
@@ -1900,6 +2471,79 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "stepper": {
+      "$ref": "#/definitions/stepperPropsSchema",
+      "definitions": {
+        "stepperPropsSchema": {
+          "type": "object",
+          "properties": {
+            "steps": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string",
+                    "description": "Step title"
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Step description"
+                  }
+                },
+                "required": [
+                  "label"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Step items array (required)"
+            },
+            "current": {
+              "type": "number",
+              "default": 0,
+              "description": "Current step index (0-based)"
+            },
+            "status": {
+              "type": "string",
+              "enum": [
+                "process",
+                "error"
+              ],
+              "default": "process",
+              "description": "Current step status"
+            },
+            "orientation": {
+              "type": "string",
+              "enum": [
+                "horizontal",
+                "vertical"
+              ],
+              "default": "horizontal",
+              "description": "Layout direction"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md"
+              ],
+              "default": "md",
+              "description": "Size"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "required": [
+            "steps"
+          ],
+          "additionalProperties": false,
+          "description": "Stepper. Step-by-step progress indicator."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "switch": {
       "$ref": "#/definitions/switchPropsSchema",
       "definitions": {
@@ -2255,12 +2899,107 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "tagInput": {
+      "$ref": "#/definitions/tagInputPropsSchema",
+      "definitions": {
+        "tagInputPropsSchema": {
+          "type": "object",
+          "properties": {
+            "value": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Controlled tags array"
+            },
+            "defaultValue": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Default tags"
+            },
+            "onChange": {
+              "description": "Tags change callback (tags: string[]) => void"
+            },
+            "placeholder": {
+              "type": "string",
+              "default": "태그 입력 후 Enter",
+              "description": "Input placeholder"
+            },
+            "max": {
+              "type": "number",
+              "description": "Maximum number of tags"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "Disabled"
+            },
+            "allowDuplicates": {
+              "type": "boolean",
+              "default": false,
+              "description": "Allow duplicate tags"
+            },
+            "label": {
+              "type": "string",
+              "description": "Label text"
+            },
+            "description": {
+              "type": "string",
+              "description": "Helper text below input"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "Size"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Tag input. Enter key to add, Backspace to delete last tag."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "textArea": {
       "$ref": "#/definitions/textAreaPropsSchema",
       "definitions": {
         "textAreaPropsSchema": {
           "type": "object",
           "properties": {
+            "label": {
+              "type": "string",
+              "description": "Label text above the textarea"
+            },
+            "description": {
+              "type": "string",
+              "description": "Helper/error description below the textarea"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "lg",
+                "md"
+              ],
+              "description": "Font size variant (lg: 16px, md: 14px)"
+            },
+            "resize": {
+              "type": "string",
+              "enum": [
+                "default",
+                "auto",
+                "none"
+              ],
+              "description": "Resize mode (default: manual, auto: auto-grow, none: fixed)"
+            },
             "error": {
               "type": "boolean",
               "description": "Error state (auto aria-invalid)"
@@ -2327,7 +3066,7 @@
             }
           },
           "additionalProperties": false,
-          "description": "Multi-line text input. Built-in character counter."
+          "description": "Multi-line text input with label, description, character counter, and resize modes."
         }
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
@@ -2661,6 +3400,94 @@
       },
       "$schema": "http://json-schema.org/draft-07/schema#"
     },
+    "toggleGroup": {
+      "$ref": "#/definitions/toggleGroupPropsSchema",
+      "definitions": {
+        "toggleGroupPropsSchema": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "single",
+                "multiple"
+              ],
+              "default": "single",
+              "description": "Selection mode"
+            },
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "value": {
+                    "type": "string",
+                    "description": "Item value"
+                  },
+                  "label": {
+                    "description": "Display label (ReactNode)"
+                  },
+                  "icon": {
+                    "description": "Icon (ReactNode)"
+                  },
+                  "disabled": {
+                    "type": "boolean",
+                    "description": "Disabled"
+                  }
+                },
+                "required": [
+                  "value"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Toggle items array (required)"
+            },
+            "value": {
+              "description": "Controlled value (string | string[])"
+            },
+            "defaultValue": {
+              "description": "Default value"
+            },
+            "onValueChange": {
+              "description": "Value change callback"
+            },
+            "variant": {
+              "type": "string",
+              "enum": [
+                "default",
+                "outline"
+              ],
+              "default": "default",
+              "description": "Style variant"
+            },
+            "size": {
+              "type": "string",
+              "enum": [
+                "sm",
+                "md",
+                "lg"
+              ],
+              "default": "md",
+              "description": "Size"
+            },
+            "disabled": {
+              "type": "boolean",
+              "description": "Disable all items"
+            },
+            "className": {
+              "type": "string",
+              "description": "Style override"
+            }
+          },
+          "required": [
+            "items"
+          ],
+          "additionalProperties": false,
+          "description": "Toggle group / Segment control. Based on Radix ToggleGroup."
+        }
+      },
+      "$schema": "http://json-schema.org/draft-07/schema#"
+    },
     "tooltip": {
       "$ref": "#/definitions/tooltipPropsSchema",
       "definitions": {