iter(g50): 新增 datePicker 日期选择组件

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T04:12:36.698Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T04:13:49.611Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -1284,6 +1284,33 @@ autoComplete({ value: acValue, placeholder: '输入组件名', options: [{ value
 
 现场演示：apps/docs/demo.html#sec-autocomplete
 
+### datePicker — 日期选择 DatePicker
+
+参数：
+
+- value：Signal<string> —— 选中日期（YYYY-MM-DD）信号；不传则内部维护
+- placeholder：string —— 未选时占位文案；缺省「请选择日期」
+- min：string —— 最早可选日期（含，YYYY-MM-DD）；更早的日置灰不可点
+- max：string —— 最晚可选日期（含，YYYY-MM-DD）；更晚的日置灰不可点
+- disabled：boolean | Signal<boolean> —— 禁用触发器
+- onChange：(date: string) => void —— 选中回调（点击日期或 Enter）
+
+示例：
+
+```
+datePicker({ value: dateVal, min: '2026-10-20', max: '2026-10-31', onChange: (d) => toast.success(d) })
+```
+
+手把手：
+
+1. 点触发器展开当月网格，打开时视图自动对准已选日期（无选中则今天）
+2. ‹ › 翻月，底部「今天」一键跳今天并提交；今天用描边标记、选中用实心底色
+3. 键盘：←→ 逐日、↑↓ 逐周、PageUp/PageDown 逐月、Enter 提交，跨月会自动翻页
+4. min / max 为闭区间，越界日期置灰不可点也不可键盘选中
+5. value 传信号即受控；Esc 收起（与弹窗/抽屉共用逐层关闭栈）
+
+现场演示：apps/docs/demo.html#sec-datepicker
+
 API 速览：
 
 - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用；type 缺省 button（表单内不隐式提交）
@@ -1336,6 +1363,7 @@ API 速览：
 - cascader(props)：级联选择，多列联动面板（悬停下钻 / 点击提交），value 为路径数组信号，changeOnSelect 允许停在中间层，全键盘可操作
 - splitter(props)：可拖拽分栏容器，分隔条支持指针拖拽 / 方向键微调 / 双击复位，sizes 为百分比数组信号
 - autoComplete(props)：输入联想，输入即过滤候选、↑↓ 环形高亮 / Enter 选中 / Esc 收起，options 可传函数做远程联想
+- datePicker(props)：日期选择，单月网格 + 翻月 / 今天快捷键，value 为 YYYY-MM-DD 信号，min/max 闭区间限制，方向键逐日逐周可导航
 
 一行用法：