@nexus-cross/design-system 1.0.3 → 1.0.4

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/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#"
+}

package/dist/schemas/stepper.json

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