@ncds/ui-admin-mcp 1.0.0-alpha.10

package/data/range-date-picker-with-buttons.json

@@ -0,0 +1,273 @@
+{
+  "name": "range-date-picker-with-buttons",
+  "exportName": "RangeDatePickerWithButtons",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "input",
+  "description": "기간 옵션 버튼이 내장된 RangeDatePicker 확장 컴포넌트로 빠른 기간 설정을 지원합니다",
+  "aliases": [
+    "기간 선택 버튼",
+    "빠른 기간",
+    "date range buttons",
+    "오늘",
+    "1주",
+    "1개월",
+    "RangeDatePickerWithButtons"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "시작일·종료일 동일 Format·동일 Size를 유지하며 기간 옵션 ButtonGroup으로 빠른 기간 설정이 필요한 경우",
+    "overlap/period 유효성 검증으로 잘못된 입력을 방지해야 하는 경우"
+  ],
+  "forbiddenRules": [
+    "시작일과 종료일의 Format 불일치 금지",
+    "기간 옵션 ButtonGroup 3개 이하 또는 8개 이상 구성 금지",
+    "시작일·종료일 DatePicker 사이즈 불일치 금지",
+    "종료일에 isEndDate 수동 false 설정 금지",
+    "조회 화면에서 Disabled Field 사용 금지",
+    "텍스트 입력 불가 UX 금지",
+    "ButtonGroup 없이 RangeDatePicker 단독 사용 시 기간 프리셋 누락 금지",
+    "구분자 ~ 외 다른 기호 사용 금지"
+  ],
+  "seeAlso": [
+    "range-date-picker",
+    "date-picker"
+  ],
+  "usageExamples": {
+    "default": {
+      "startDateOptions": {
+        "currentDate": "2026-03-17"
+      },
+      "endDateOptions": {
+        "currentDate": "2026-03-24"
+      },
+      "currentButtonId": "7DAYS",
+      "periodKeys": [
+        "TODAY",
+        "7DAYS",
+        "1MONTHS",
+        "3MONTHS",
+        "1YEAR",
+        "ENTIRE"
+      ]
+    }
+  },
+  "props": {
+    "currentButtonId": {
+      "type": "string",
+      "required": true,
+      "rawType": "keyof T & string"
+    },
+    "endDateOptions": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
+    },
+    "onDateValidation": {
+      "type": "function",
+      "required": false
+    },
+    "periodItems": {
+      "type": "string",
+      "required": false,
+      "rawType": "T | undefined"
+    },
+    "periodKeys": {
+      "type": "object",
+      "required": true,
+      "rawType": "(keyof T & string)[]"
+    },
+    "setCurrentButtonId": {
+      "type": "function",
+      "required": true
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "sm",
+        "xs"
+      ],
+      "default": "xs"
+    },
+    "startDateOptions": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
+    },
+    "useYesterdayAsEndDate": {
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "validationOption": {
+      "type": "object",
+      "required": false,
+      "properties": {
+        "initDate": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "startDate": {
+              "type": "string",
+              "required": false
+            },
+            "endDate": {
+              "type": "string",
+              "required": false
+            }
+          }
+        },
+        "setting": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "unit": {
+              "type": "enum",
+              "required": true,
+              "values": [
+                "M",
+                "Q",
+                "d",
+                "day",
+                "days",
+                "h",
+                "hour",
+                "hours",
+                "m",
+                "millisecond",
+                "milliseconds",
+                "minute",
+                "minutes",
+                "month",
+                "months",
+                "ms",
+                "quarter",
+                "quarters",
+                "s",
+                "second",
+                "seconds",
+                "w",
+                "week",
+                "weeks",
+                "y",
+                "year",
+                "years"
+              ]
+            },
+            "period": {
+              "type": "number",
+              "required": true
+            }
+          }
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-range-date-picker-with-buttons"
+  ],
+  "usage": {
+    "import": "import { RangeDatePickerWithButtons } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<RangeDatePickerWithButtons currentButtonId=\"\" endDateOptions=\"\" periodKeys=\"\" setCurrentButtonId=\"\" startDateOptions=\"\" />",
+      "size:sm": "<RangeDatePickerWithButtons size=\"sm\" currentButtonId=\"\" endDateOptions=\"\" periodKeys=\"\" setCurrentButtonId=\"\" startDateOptions=\"\" />",
+      "size:xs": "<RangeDatePickerWithButtons size=\"xs\" currentButtonId=\"\" endDateOptions=\"\" periodKeys=\"\" setCurrentButtonId=\"\" startDateOptions=\"\" />"
+    }
+  }
+}

package/data/range-date-picker.json

@@ -0,0 +1,259 @@
+{
+  "name": "range-date-picker",
+  "exportName": "RangeDatePicker",
+  "importPath": "@ncds/ui-admin",
+  "jsRequired": false,
+  "category": "input",
+  "description": "RangeDatePicker는 시작일~종료일 기간 범위를 선택해야 하는 경우 사용하는 복합 선택 위젯입니다. 검색 기간 설정, 노출 기간 설정, 이벤트 기간 설정 등 두 날짜의 쌍(Pair)이 필요한 모든 상황에서 사용합니다.",
+  "aliases": [
+    "범위날짜선택",
+    "RangeDatePicker",
+    "RangeDatePickerWithButtons",
+    "컴포넌트",
+    "기간선택",
+    "시작일",
+    "종료일",
+    "날짜범위",
+    "ButtonGroup",
+    "기간옵션",
+    "periodKeys",
+    "validationOption",
+    "onDateValidation",
+    "overlap",
+    "period",
+    "NCDS"
+  ],
+  "hasChildren": false,
+  "whenToUse": [
+    "시작일·종료일 동일 Format·동일 Size를 유지",
+    "기간 옵션 ButtonGroup(4~7개)으로 빠른 기간 설정 지원",
+    "overlap/period 유효성 검증으로 잘못된 입력 방지"
+  ],
+  "forbiddenRules": [
+    "시작일과 종료일의 Format 불일치 금지",
+    "기간 옵션 ButtonGroup 3개 이하 또는 8개 이상 구성 금지",
+    "시작일·종료일 DatePicker 사이즈 불일치 금지",
+    "종료일에 isEndDate 수동 false 설정 금지",
+    "조회 화면에서 Disabled Field 사용 금지",
+    "텍스트 입력 불가 UX 금지",
+    "ButtonGroup 없이 기간 프리셋 누락 금지",
+    "구분자 ~ 외 다른 기호 사용 금지"
+  ],
+  "seeAlso": [
+    "date-picker",
+    "button-group"
+  ],
+  "usageExamples": {
+    "default": {
+      "startDateOptions": {
+        "currentDate": "2026-03-01"
+      },
+      "endDateOptions": {
+        "currentDate": "2026-03-24"
+      }
+    },
+    "withSize": {
+      "startDateOptions": {
+        "currentDate": "2026-03-01"
+      },
+      "endDateOptions": {
+        "currentDate": "2026-03-24"
+      },
+      "size": "sm"
+    }
+  },
+  "props": {
+    "endDateOptions": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
+    },
+    "onDateValidation": {
+      "type": "function",
+      "required": false
+    },
+    "size": {
+      "type": "enum",
+      "required": false,
+      "values": [
+        "sm",
+        "xs"
+      ],
+      "default": "xs"
+    },
+    "startDateOptions": {
+      "type": "object",
+      "required": true,
+      "rawType": "import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/packages/ui-admin/src/components/date-picker/DatePicker\").DatePickerProps",
+      "properties": {
+        "size": {
+          "type": "enum",
+          "required": false,
+          "values": [
+            "sm",
+            "xs"
+          ]
+        },
+        "shouldFocus": {
+          "type": "boolean",
+          "required": false
+        },
+        "currentDate": {
+          "type": "string",
+          "required": true
+        },
+        "datePickerOptions": {
+          "type": "object",
+          "required": false,
+          "rawType": "Partial<import(\"/Users/nhncommerce/Desktop/company/ai-driven-ncds/node_modules/flatpickr/dist/types/options\").BaseOptions> | undefined"
+        },
+        "destructive": {
+          "type": "string",
+          "required": false
+        },
+        "placeholder": {
+          "type": "string",
+          "required": false
+        },
+        "isEndDate": {
+          "type": "boolean",
+          "required": false
+        },
+        "className": {
+          "type": "string",
+          "required": false
+        },
+        "onChangeDate": {
+          "type": "function",
+          "required": true
+        },
+        "onValidationError": {
+          "type": "function",
+          "required": false
+        }
+      }
+    },
+    "validationOption": {
+      "type": "object",
+      "required": false,
+      "properties": {
+        "initDate": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "startDate": {
+              "type": "string",
+              "required": false
+            },
+            "endDate": {
+              "type": "string",
+              "required": false
+            }
+          }
+        },
+        "setting": {
+          "type": "object",
+          "required": false,
+          "properties": {
+            "unit": {
+              "type": "enum",
+              "required": true,
+              "values": [
+                "M",
+                "Q",
+                "d",
+                "day",
+                "days",
+                "h",
+                "hour",
+                "hours",
+                "m",
+                "millisecond",
+                "milliseconds",
+                "minute",
+                "minutes",
+                "month",
+                "months",
+                "ms",
+                "quarter",
+                "quarters",
+                "s",
+                "second",
+                "seconds",
+                "w",
+                "week",
+                "weeks",
+                "y",
+                "year",
+                "years"
+              ]
+            },
+            "period": {
+              "type": "number",
+              "required": true
+            }
+          }
+        }
+      }
+    }
+  },
+  "html": {},
+  "bemClasses": [
+    "ncua-range-date-picker"
+  ],
+  "usage": {
+    "import": "import { RangeDatePicker } from '@ncds/ui-admin';",
+    "react": {
+      "default": "<RangeDatePicker endDateOptions=\"\" startDateOptions=\"\" />",
+      "size:sm": "<RangeDatePicker size=\"sm\" endDateOptions=\"\" startDateOptions=\"\" />",
+      "size:xs": "<RangeDatePicker size=\"xs\" endDateOptions=\"\" startDateOptions=\"\" />"
+    }
+  }
+}