Merge branch 'worktree-agent-ad7403b5194d75449'

docs/components/051-calendar.md

@@ -53,3 +53,4 @@ ui.Render(view, 400, 300, 1)
 - MyGo 的 `ui.Calendar` 固定周一起始、只有英文且不支持禁用日期（ui/date.go:85-160），因此本组件基于 `RadioBase` 自绘网格，不复用 `ui.Calendar`。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/052-date-picker.md

@@ -33,12 +33,13 @@ ui.Render(view, 400, 300, 1)
 | `Today` | `Date` | 零值（系统时钟） | 弹层日历中的今日标记；空值时弹层打开到此月份。 |
 | `Clearable` | `bool` | false | 显示清空按钮；清空输入后提交表示“无日期”。 |
 | `Placeholder` | `string` | 内置“选择日期” | 空输入框的占位文字。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用输入与弹层。 |
 | `Label` | `string` | 占位文字 | 辅助技术名称。 |
 
 ## 状态
 
-默认、悬停（边框加深）、聚焦（焦点色边框）、错误（危险色边框 + 下方说明，输入保留）、禁用。弹层内日历状态同 Calendar。
+默认、悬停（边框加深）、聚焦（焦点色边框）、只读（背景与边框减弱，可选择复制）、错误（危险色边框 + 下方说明，输入保留）、禁用。弹层内日历状态同 Calendar。
 
 ## 事件
 
@@ -54,6 +55,7 @@ ui.Render(view, 400, 300, 1)
 
 - 无效或越界的输入（如 2026-02-30）显示具体错误并保留原文，不会被修正为相邻日期。
 - MyGo 的 `ui.DateInput` 固定格式且不可键入（ui/date.go:13），因此本组件组合 `TextInputBase` 与自绘日历弹层（`PopoverBase`）。
-- 暂不提供只读模式：MyGo v0.2.10 未公开 TextInputBase 的只读开关。
+- 只读模式沿用 TextInput 的做法：编辑副本并在每帧恢复，文本仍可选择与复制。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/053-date-range-picker.md

@@ -30,6 +30,7 @@ ui.Render(view, 400, 300, 1)
 | `DisableDate` | `func(Date) bool` | nil | 不可选日期；范围内包含此类日期时拒绝并提示。 |
 | `WeekStart` | `WeekStart` | `WeekStartLocale` | 周起始日。 |
 | `Today` | `Date` | 零值（系统时钟） | 今日标记与空值时的起始月份。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用。 |
 | `Label` | `string` | 内置“日期范围” | 辅助技术名称。 |
 
@@ -55,3 +56,4 @@ ui.Render(view, 400, 300, 1)
 - `DateRange` 为闭区间，`Days()` 计入两端。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/054-time-picker.md

@@ -30,12 +30,13 @@ ui.Render(view, 400, 300, 1)
 | `SecondStep` | `int` | 0（即 1） | 秒步长，必须整除 60。 |
 | `Min` | `TimeOfDay` | 00:00:00 | 最早时间。 |
 | `Max` | `TimeOfDay` | 零值（即 23:59:59） | 最晚时间。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用。 |
 | `Label` | `string` | 空 | 组名；各段名称为“Label: 时/分/秒”。 |
 
 ## 状态
 
-默认、悬停、聚焦段（酒红填充）、错误（危险色边框 + 说明，草稿保留）、禁用。弹层列表中超出范围的项禁用。
+默认、悬停、聚焦段（酒红填充 + 键盘焦点环）、只读、错误（危险色边框 + 说明，草稿保留）、禁用。弹层列表中超出范围的项禁用。
 
 ## 事件
 
@@ -52,8 +53,9 @@ ui.Render(view, 400, 300, 1)
 
 ## 限制
 
-- 超出范围或不符合步长的时间会提示，不会被自动夹取或取整。
+- 超出范围或不符合步长的时间会提示，不会被自动夹取或取整；键入超出段范围的数字（如小时 29）会保留显示并报错。
 - 段顺序固定为“时:分:秒 上午/下午”，zh-CN 下上午/下午也位于末尾。
 - MyGo 的 `ui.TimeInput` 只有时分且无 12 小时制、步长和范围（ui/timeinput.go:18），因此本组件自绘分段。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/055-time-range-picker.md

@@ -31,6 +31,7 @@ ui.Render(view, 400, 300, 1)
 | `Min` | `TimeOfDay` | 00:00:00 | 两端最早时间。 |
 | `Max` | `TimeOfDay` | 零值（即 23:59:59） | 两端最晚时间。 |
 | `AllowOvernight` | `bool` | false | 允许结束早于开始，表示次日结束，并显示“次日”。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用。 |
 | `Label` | `string` | 空 | 整组名称。 |
 
@@ -53,3 +54,4 @@ ui.Render(view, 400, 300, 1)
 - `TimeRange.Overnight()` 报告是否跨午夜。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/056-date-time-picker.md

@@ -29,6 +29,7 @@ ui.Render(view, 400, 300, 1)
 | 字段 | 类型 | 默认值 | 含义 |
 | --- | --- | --- | --- |
 | `Location` | `*time.Location` | 必填 | 用户编辑所用时区；为 nil 时 panic。 |
+| `Layout` | `string` | `2006-01-02` | 日期部分的 Go 时间布局，用于显示与错误说明。 |
 | `Min` | `time.Time` | 零值 | 最早时刻。 |
 | `Max` | `time.Time` | 零值 | 最晚时刻。 |
 | `Seconds` | `bool` | false | 显示秒。 |
@@ -36,6 +37,7 @@ ui.Render(view, 400, 300, 1)
 | `MinuteStep` | `int` | 0（即 1） | 分钟步长。 |
 | `WeekStart` | `WeekStart` | `WeekStartLocale` | 周起始日。 |
 | `Today` | `Date` | 零值（系统时钟） | 今日标记与空值时的默认日期。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用。 |
 | `Label` | `string` | 内置占位文字 | 辅助技术名称。 |
 
@@ -60,3 +62,4 @@ ui.Render(view, 400, 300, 1)
 - 空值（零 `time.Time`）打开时默认今天 00:00。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/057-month-picker.md

@@ -29,6 +29,7 @@ ui.Render(view, 400, 300, 1)
 | `DisableMonth` | `func(YearMonth) bool` | nil | 不可选月份。 |
 | `Clearable` | `bool` | false | 有值时显示清空按钮。 |
 | `Today` | `Date` | 零值（系统时钟） | 标记当前月份。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用。 |
 | `Label` | `string` | 内置“选择月份” | 辅助技术名称。 |
 
@@ -53,3 +54,4 @@ ui.Render(view, 400, 300, 1)
 - 键盘移到不可选月份时焦点保持在原处，可继续移动。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。

docs/components/058-year-picker.md

@@ -29,6 +29,7 @@ ui.Render(view, 400, 300, 1)
 | `DisableYear` | `func(int) bool` | nil | 不可选年份。 |
 | `Clearable` | `bool` | false | 有值时显示清空按钮。 |
 | `Today` | `Date` | 零值（系统时钟） | 标记当前年份。 |
+| `ReadOnly` | `bool` | false | 只读：可聚焦、可复制（Cmd/Ctrl+C），不能修改，不打开弹层。 |
 | `Disabled` | `bool` | false | 禁用。 |
 | `Label` | `string` | 内置“选择年份” | 辅助技术名称。 |
 
@@ -53,3 +54,4 @@ ui.Render(view, 400, 300, 1)
 - 只支持公元 1 年及以后；值为负数时 panic。
 - 日期与时间值不带时区：`Date`、`YearMonth`、`TimeOfDay` 只保存日历字段，组件内部计算不做 UTC 转换。
 - `Today` 为零值时读取 `c.Now()`（系统本地时区）；需要固定“今天”（测试、跨时区应用）时显式传入。
+- 无障碍：MyGo v0.2.10 没有公开设置弹出按钮展开状态（`expanded`）、数值范围（`hasRange`/`accRange`）与值（`accValue`）的接口，这些字段只在 MyGo 内部组件中赋值（ui/element.go:286-295，例如 ui/base.go:297、ui/indicators.go:61）。因此触发器只能声明为 `RolePopUpButton` 而无法报告展开状态；时间段以 `Description` 读出当前值与范围，错误通过 `Error()` 关联。