# UGCalendar 日历

> 适配器：React；状态：available；slug：`calendar`。

提供可受控的单月日期选择、范围限制与完整键盘导航。

## 适用场景

- 在页面内展示单月日期网格，让用户选择一个本地日期并限制可选范围。

## 不适用场景

- 只需要浏览器原生日期字段时使用原生 date input；日期弹出选择器需要组合 Popover 与 Calendar。

## 公开入口

- 包入口：`@ug666/ui-react/components`
- 公开成员：`UGCalendar`
- 交互文档：[https://ui.ug666.top/react/components/calendar](https://ui.ug666.top/react/components/calendar)

```tsx
import { UGCalendar } from '@ug666/ui-react/components'
```

## 使用规则

- value/modelValue 与 month 分别控制选中日期和可见月份；日期语义是本地 Date，不在组件内处理时区或业务请求。
- 受控值使用当前组件声明的 value/onValueChange 或公开回调。
- 涉及 Hook、Portal 或浏览器状态时保留 client boundary。
- 只通过公开 Props、事件、插槽、class/className 和语义 Token 扩展。

## 相关候选

- [popover](https://ui.ug666.top/ai/react/components/popover.md)
- [input](https://ui.ug666.top/ai/react/components/input.md)
- [form](https://ui.ug666.top/ai/react/components/form.md)

## 生成前检查

- 当前适配器是否真实提供该组件。
- 导入路径、组件名和 API 是否存在于当前版本类型声明。
- 是否覆盖长文本、窄容器、键盘、焦点、disabled、loading 和错误状态。