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

package/dist/schemas/marquee.json

@@ -13,30 +13,36 @@
             "down"
           ],
           "default": "left",
-          "description": "방향"
+          "description": "Direction"
         },
         "speed": {
           "type": "number",
           "default": 40,
-          "description": "애니메이션 속도 (초)"
+          "description": "Animation speed (seconds)"
         },
         "pauseOnHover": {
           "type": "boolean",
           "default": false,
-          "description": "호버 시 일시정지"
+          "description": "Pause on hover"
         },
         "gap": {
           "type": "number",
           "default": 16,
-          "description": "아이템 간격 (px)"
+          "description": "Item gap (px)"
+        },
+        "children": {
+          "description": "Content to repeat (ReactNode, required)"
+        },
+        "style": {
+          "description": "Inline style (CSSProperties)"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "마퀴 (흐르는 텍스트/요소)."
+      "description": "Marquee (scrolling text/elements)."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/modalCall.json

@@ -5,16 +5,94 @@
       "type": "object",
       "properties": {
         "component": {
-          "description": "모달 컴포넌트 (필수)"
+          "description": "Modal component (required). Automatically receives close/resolve as props"
         },
         "props": {
           "type": "object",
           "additionalProperties": {},
-          "description": "컴포넌트에 전달할 props"
+          "description": "Props to pass to component"
+        },
+        "id": {
+          "type": "string",
+          "description": "Modal ID (used for duplicate check)"
+        },
+        "layout": {
+          "type": "string",
+          "enum": [
+            "default",
+            "bottom-sheet",
+            "slide-left",
+            "slide-right",
+            "full-page",
+            "full-page-reverse",
+            "draggable"
+          ],
+          "description": "Layout"
+        },
+        "animation": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "Animation name"
+            },
+            "mobile": {
+              "type": "string",
+              "description": "Mobile animation name"
+            },
+            "delay": {
+              "type": "number",
+              "description": "Delay (ms)"
+            },
+            "duration": {
+              "type": "number",
+              "description": "Duration (ms)"
+            },
+            "timingFunc": {
+              "type": "string",
+              "description": "Timing function"
+            },
+            "leaveTimingFunc": {
+              "type": "string",
+              "description": "Exit timing function"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Modal animation"
+        },
+        "scrollEnable": {
+          "type": "boolean",
+          "description": "Allow background scroll"
+        },
+        "isToggle": {
+          "type": "boolean",
+          "description": "Toggle mode (close on re-call of same modal)"
+        },
+        "isAlone": {
+          "type": "boolean",
+          "description": "Alone mode (close all existing modals before opening)"
+        },
+        "duplicateCheck": {
+          "type": "boolean",
+          "description": "Prevent duplicate opening of same component"
+        },
+        "disableEscapeKeyPress": {
+          "type": "boolean",
+          "description": "Disable close via ESC key"
+        },
+        "componentName": {
+          "type": "string",
+          "description": "Modal identifier name (used for duplicate check, modal search)"
+        },
+        "onOpen": {
+          "description": "Callback when modal opens"
+        },
+        "onClose": {
+          "description": "Callback when modal closes"
         }
       },
       "additionalProperties": false,
-      "description": "modal() 함수 호출 형태. component는 close/resolve를 자동으로 props로 받는다."
+      "description": "modal() function call options. component automatically receives close/resolve as props."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/modalTemplate.json

@@ -5,10 +5,10 @@
       "type": "object",
       "properties": {
         "title": {
-          "description": "헤더 제목 (ReactNode)"
+          "description": "Header title (ReactNode)"
         },
         "desc": {
-          "description": "헤더 설명 (ReactNode)"
+          "description": "Header description (ReactNode)"
         },
         "layout": {
           "type": "string",
@@ -22,51 +22,104 @@
             "draggable"
           ],
           "default": "default",
-          "description": "레이아웃"
+          "description": "Layout"
         },
         "showDim": {
           "type": "boolean",
           "default": true,
-          "description": "딤 배경 표시"
+          "description": "Show dim overlay"
         },
         "dimClose": {
           "type": "boolean",
           "default": true,
-          "description": "딤 클릭 시 닫기"
+          "description": "Close on dim click"
         },
         "hideHeader": {
           "type": "boolean",
           "default": false,
-          "description": "헤더 숨김"
+          "description": "Hide header"
         },
         "hideFooter": {
           "type": "boolean",
           "default": true,
-          "description": "푸터 숨김"
+          "description": "Hide footer"
         },
         "footer": {
-          "description": "커스텀 푸터 (ReactElement)"
+          "description": "Custom footer (ReactElement)"
+        },
+        "animation": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "Animation name"
+            },
+            "mobile": {
+              "type": "string",
+              "description": "Mobile animation name"
+            },
+            "delay": {
+              "type": "number",
+              "description": "Delay (ms)"
+            },
+            "duration": {
+              "type": "number",
+              "description": "Duration (ms)"
+            },
+            "timingFunc": {
+              "type": "string",
+              "description": "Timing function"
+            },
+            "leaveTimingFunc": {
+              "type": "string",
+              "description": "Exit timing function"
+            }
+          },
+          "additionalProperties": false,
+          "description": "Modal animation"
         },
         "enableDrag": {
           "type": "boolean",
-          "default": false,
-          "description": "드래그 활성화 (draggable 레이아웃)"
+          "default": true,
+          "description": "Enable drag (bottom-sheet/draggable layouts)"
         },
         "dragPersistKey": {
           "type": "string",
-          "description": "드래그 위치 저장 키"
+          "description": "Drag position persistence key"
+        },
+        "close": {
+          "description": "Modal close function (isAnimation?: boolean) => void (auto-injected)"
+        },
+        "children": {
+          "description": "Modal body (ReactNode, required)"
+        },
+        "className": {
+          "type": "string",
+          "description": "Root wrapper style"
         },
         "innerClassName": {
           "type": "string",
-          "description": "모달 본체 스타일"
+          "description": "Modal body style"
         },
         "bodyClassName": {
           "type": "string",
-          "description": "바디 영역 스타일"
+          "description": "Body area style"
+        },
+        "footerClassName": {
+          "type": "string",
+          "description": "Footer area style"
+        },
+        "dimClassName": {
+          "type": "string",
+          "description": "Dim overlay style"
+        },
+        "headerClassName": {
+          "type": "string",
+          "description": "Header area style"
         }
       },
       "additionalProperties": false,
-      "description": "모달 템플릿. 모든 모달 컴포넌트는 반드시 ModalTemplate으로 감싸야 한다."
+      "description": "Modal template. All modal components must be wrapped with ModalTemplate."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/numberInput.json

@@ -9,56 +9,86 @@
             "number",
             "string"
           ],
-          "description": "현재 값"
+          "description": "Current value"
         },
         "size": {
           "type": "string",
           "enum": [
             "sm",
             "md",
-            "lg"
+            "lg",
+            "xl"
           ],
           "default": "md",
-          "description": "크기"
+          "description": "Size"
         },
         "error": {
           "type": "boolean",
-          "description": "에러 상태"
+          "description": "Error state"
         },
         "min": {
           "type": "number",
-          "description": "최소값"
+          "description": "Minimum value"
         },
         "max": {
           "type": "number",
-          "description": "최대값"
+          "description": "Maximum value"
         },
         "step": {
           "type": "number",
           "default": 1,
-          "description": "증감 단위"
+          "description": "Step increment"
         },
         "digit": {
           "type": "number",
           "default": 0,
-          "description": "소수 자릿수"
+          "description": "Decimal places"
         },
         "hideButtons": {
           "type": "boolean",
           "default": false,
-          "description": "기본 스핀 버튼 숨김. numberInputBind로 외부 버튼에 이벤트 부착 시 사용"
+          "description": "Hide default spin buttons. Use with numberInputBind for external button event binding"
         },
         "disabled": {
           "type": "boolean",
-          "description": "비활성"
+          "description": "Disabled"
+        },
+        "readOnly": {
+          "type": "boolean",
+          "description": "Read-only (includes hiding spin buttons)"
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder"
+        },
+        "name": {
+          "type": "string",
+          "description": "Form field name"
+        },
+        "id": {
+          "type": "string",
+          "description": "Element ID"
+        },
+        "autoFocus": {
+          "type": "boolean",
+          "description": "Auto focus"
+        },
+        "onValueChange": {
+          "description": "Value change callback (value: number | undefined) => void"
+        },
+        "onBlur": {
+          "description": "Blur callback"
+        },
+        "onFocus": {
+          "description": "Focus callback"
         },
         "className": {
           "type": "string",
-          "description": "스타일 오버라이드"
+          "description": "Style override"
         }
       },
       "additionalProperties": false,
-      "description": "숫자 입력. 꾹 누르면 가속 증감. ref로 increment/decrement 메서드 노출. numberInputBind(ref, direction) 함수로 외부 버튼에 동일한 가속 이벤트 바인딩 가능."
+      "description": "Number input. Accelerated increment on long press. Exposes increment/decrement methods via ref. numberInputBind(ref, direction) binds same 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/pagination.json

@@ -6,16 +6,20 @@
       "properties": {
         "currentPage": {
           "type": "number",
-          "description": "현재 페이지 (1부터, 필수)"
+          "description": "Current page (1-based, required)"
         },
         "totalPages": {
           "type": "number",
-          "description": "전체 페이지 수 (필수)"
+          "description": "Total page count (required)"
         },
         "siblingCount": {
           "type": "number",
           "default": 1,
-          "description": "현재 페이지 양옆 표시 개수"
+          "description": "Number of pages shown on each side of current"
+        },
+        "showEdges": {
+          "type": "boolean",
+          "description": "Always show first/last page"
         },
         "size": {
           "type": "string",
@@ -24,11 +28,14 @@
             "md"
           ],
           "default": "md",
-          "description": "크기"
+          "description": "Size"
+        },
+        "onPageChange": {
+          "description": "Page change callback (page: number) => void, required"
         },
         "className": {
           "type": "string",
-          "description": "<nav> 스타일"
+          "description": "<nav> style"
         }
       },
       "required": [
@@ -36,7 +43,7 @@
         "totalPages"
       ],
       "additionalProperties": false,
-      "description": "페이지네이션. 이전/다음 + 번호 버튼."
+      "description": "Pagination. Previous/next + page number buttons."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/popover.json

@@ -5,7 +5,7 @@
       "type": "object",
       "properties": {
         "trigger": {
-          "description": "트리거 요소 (ReactNode, 필수)"
+          "description": "Trigger element (ReactNode, required)"
         },
         "side": {
           "type": "string",
@@ -16,7 +16,7 @@
             "left"
           ],
           "default": "bottom",
-          "description": "위치"
+          "description": "Position"
         },
         "align": {
           "type": "string",
@@ -26,32 +26,41 @@
             "end"
           ],
           "default": "center",
-          "description": "정렬"
+          "description": "Alignment"
         },
         "sideOffset": {
           "type": "number",
           "default": 4,
-          "description": "위치 오프셋 (px)"
+          "description": "Position offset (px)"
         },
         "alignOffset": {
           "type": "number",
-          "description": "정렬 오프셋 (px)"
+          "description": "Alignment offset (px)"
         },
         "open": {
           "type": "boolean",
-          "description": "제어 모드"
+          "description": "Controlled mode"
+        },
+        "onOpenChange": {
+          "description": "Open/close state change callback (open: boolean) => void"
+        },
+        "onClickTrigger": {
+          "description": "Callback on trigger element click. Passed to PopoverPrimitive.Trigger onClick."
+        },
+        "children": {
+          "description": "Popover body (ReactNode)"
         },
         "className": {
           "type": "string",
-          "description": "Content 스타일"
+          "description": "Content style"
         },
         "arrowClassName": {
           "type": "string",
-          "description": "Arrow 스타일"
+          "description": "Arrow style"
         }
       },
       "additionalProperties": false,
-      "description": "팝오버. Radix Popover 기반."
+      "description": "Popover. Based on Radix Popover."
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/priceInput.json

@@ -0,0 +1,104 @@
+{
+  "$ref": "#/definitions/priceInputPropsSchema",
+  "definitions": {
+    "priceInputPropsSchema": {
+      "type": "object",
+      "properties": {
+        "size": {
+          "type": "string",
+          "enum": [
+            "md",
+            "lg",
+            "xl"
+          ],
+          "default": "md",
+          "description": "Size"
+        },
+        "error": {
+          "type": "boolean",
+          "description": "Error state (shows danger border)"
+        },
+        "prefix": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {}
+          ],
+          "default": true,
+          "description": "Prefix element. true = \"$\", ReactNode = custom content, false = hidden"
+        },
+        "suffix": {
+          "description": "Suffix element after the input (e.g. \"CROSSD\", icon, ReactNode)"
+        },
+        "label": {
+          "description": "Label displayed above the input (ReactNode)"
+        },
+        "description": {
+          "description": "Description below the input. Turns red on error (ReactNode)"
+        },
+        "balance": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "Balance value in the header. Clicking fills the input"
+        },
+        "balanceLabel": {
+          "type": "string",
+          "default": "Balance",
+          "description": "Label text for balance display"
+        },
+        "balanceContent": {
+          "description": "Custom balance display (ReactNode). Replaces default text, keeps click-to-fill"
+        },
+        "maxBalance": {
+          "type": "number",
+          "description": "Max allowed value. Exceeding auto-applies error state and turns balance red"
+        },
+        "separator": {
+          "type": "boolean",
+          "default": false,
+          "description": "Display thousands separator (comma). onValueChange receives raw value without commas"
+        },
+        "align": {
+          "type": "string",
+          "enum": [
+            "left",
+            "right"
+          ],
+          "default": "left",
+          "description": "Text alignment inside the input"
+        },
+        "disabled": {
+          "type": "boolean",
+          "description": "Disabled"
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Placeholder"
+        },
+        "value": {
+          "description": "Controlled value"
+        },
+        "id": {
+          "type": "string",
+          "description": "Element ID"
+        },
+        "onValueChange": {
+          "description": "Value change callback (value: string) => void"
+        },
+        "onBalanceClick": {
+          "description": "Balance click callback (balance: string | number) => void"
+        },
+        "className": {
+          "type": "string",
+          "description": "Style override"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Price/amount input field with prefix, suffix, balance display, and auto-fill on balance click."
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}