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

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/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/datePicker.json

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

package/dist/schemas/dropdownMenu.json

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

package/dist/schemas/emptyState.json

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

package/dist/schemas/numberInput.json

@@ -4,6 +4,15 @@
     "numberInputPropsSchema": {
       "type": "object",
       "properties": {
+        "variant": {
+          "type": "string",
+          "enum": [
+            "basic",
+            "bind"
+          ],
+          "default": "basic",
+          "description": "Variant: basic (right chevron arrows) or bind (left/right +/- buttons)"
+        },
         "value": {
           "type": [
             "number",
@@ -14,12 +23,10 @@
         "size": {
           "type": "string",
           "enum": [
-            "sm",
-            "md",
             "lg",
             "xl"
           ],
-          "default": "md",
+          "default": "lg",
           "description": "Size"
         },
         "error": {
@@ -32,7 +39,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",
@@ -44,10 +51,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",
@@ -55,11 +74,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",
@@ -88,7 +107,7 @@
         }
       },
       "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#"

package/dist/schemas/nxImage.json

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

package/dist/schemas/progress.json

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

package/dist/schemas/slider.json

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