用途：<sgds-datepicker> 用于在表单中提供日期输入控件，输入框与日历下拉结合，用户既可手动输入日期，也可从日历中选择；mode="range" 时可选起止两个日期。本技能在用户需要日期选择或日期区间选择时应用。
主要能力：单日期模式（mode="single"，默认）与区间模式（mode="range"）；可通过 value 预置日期，单选格式为 DD/MM/YYYY，区间格式为 "DD/MM/YYYY - DD/MM/YYYY"；用 minDate、maxDate（ISO 8601 字符串，如 "2020-01-01T00:00:00.000Z"）限制可选日期；用 label、hintText、name、required、disabled 控制字段；用 hasFeedback 与 invalidFeedback 展示校验反馈；用 drop="up" 或 drop="down" 控制日历展开方向，noFlip 阻止自动翻转。
使用方式：直接以自定义元素形式书写，如 <sgds-datepicker label="Date of Birth" name="dob" hintText="Select your date of birth"></sgds-datepicker>；预置值示例 value="22/12/2024"；区间示例 mode="range" 配合 minDate、maxDate。监听日期变化用 addEventListener("sgds-change-date", ...)，读取 e.target.value 获得日期字符串（如 "22/12/2024"），注意没有 event.detail。
适用场景：表单中的出生日期、预约日期、请假区间、提交截止日期等需要日期或日期区间录入的界面，尤其接近视口底部时可用 drop="up" 让日历向上展开。
限制：安装与框架集成（React 19+、React ≤18、Vue、Angular）请参见 sgds-components-setup；本组件不暴露 CSS 自定义属性与 CSS parts，因此不做 CSS 样式修改；minDate、maxDate 必须为 ISO 8601 字符串；value 单一日期恒为 DD/MM/YYYY 格式；组件没有公开方法；initialValue（数组格式）自 v3.3.0 起已弃用，改用 value。