Merge branch 'worktree-agent-a9950b6fffa6f4a57'

docs/components/002-title-bar.md

@@ -24,7 +24,7 @@ mujica.TitleBar(c, "Court Records", mujica.TitleBarOptions{
 
 ## 状态
 
-- 高度取 `c.TitleBar().Height` 与 `控件高度 + 2 单位` 中较大者（默认密度 44 DIP）。
+- 最小高度取 `c.TitleBar().Height` 与 `控件高度 + 2 单位` 中较大者（默认密度 44 DIP）；标题字号随系统文本缩放，放大后标题栏随之增高。
 - 左右内边距在 `c.TitleBar().Left/Right` 之外再加 3 单位，不覆盖系统按钮；全屏时预留为 0。
 - Surface 底色，底部 1 DIP Border 分隔线。
 

docs/components/003-status-bar.md

@@ -32,8 +32,8 @@ if bar.Clicked == "bell" {
 | 字段 | 类型 | 默认值 | 含义 |
 | --- | --- | --- | --- |
 | `ID` | `string` | 必填 | 稳定键，也是 `Clicked` 的值；为空或重复 panic。 |
-| `Text` | `string` | "" | 状态文字（12 DIP）。 |
-| `Icon` | `*ui.SVG` | nil | 前置图标（14 DIP）。 |
+| `Text` | `string` | "" | 状态文字（12 DIP，随系统文本缩放）。 |
+| `Icon` | `*ui.SVG` | nil | 前置图标（16 DIP）。 |
 | `Tone` | `StatusItemTone` | `StatusItemNeutral` | 语义色：Neutral、Success、Warning、Danger、Info。 |
 | `ShowProgress` | `bool` | false | 显示 64 DIP 进度条。 |
 | `Progress` | `float32` | 0 | 进度 0–1，超出 panic。 |
@@ -45,7 +45,8 @@ if bar.Clicked == "bell" {
 
 - 默认：Surface 底色，顶部 Border 线，组内条目以细线分隔。
 - 操作条目：悬停 SurfaceHover，按下 Selection，键盘焦点环。
-- 折叠：按“右组末项 → 左组首项”的顺序隐藏 `Secondary` 条目，直到放得下；显示 `+N`，悬停提示列出被隐藏条目，无障碍名称为“另有 N 项”。主要条目永不隐藏。
+- 折叠：按“右组末项 → 左组首项”的顺序隐藏 `Secondary` 条目，直到放得下（按实际宽度计算，操作条目至少 28 DIP，含条目间距）；显示 `+N` 按钮，无障碍名称为“另有 N 项”，点击或 Enter/Space 打开弹层，列出被隐藏的条目，其中的操作照常可用，执行后弹层关闭。主要条目永不隐藏。
+- 文本放大时状态栏随文字增高。
 - 进度：AccentText 填充，Border 轨道，描述为百分比。
 
 ## 事件
@@ -54,10 +55,9 @@ if bar.Clicked == "bell" {
 
 ## 键盘操作
 
-Tab 到达操作条目，Enter 或 Space 触发。纯文字条目不进入 Tab 序列。
+Tab 到达操作条目和 `+N` 按钮，Enter 或 Space 触发。`+N` 打开的弹层中 Tab 依次到达隐藏的操作，Escape 关闭弹层并把焦点还给 `+N`。纯文字条目不进入 Tab 序列。
 
 ## 限制
 
 - 折叠依据上一帧的宽度和文字测量估算，窗口缩放后下一帧生效。
-- 被隐藏条目只在 `+N` 的提示中列出，提示仅悬停可见，键盘用户通过无障碍名称得知数量。
 - 不提供不确定进度动画；需要时在 `Text` 中说明。

docs/components/007-scroll-area.md

@@ -30,7 +30,7 @@ mujica.ScrollArea(c, &offset, mujica.ScrollAreaOptions{Label: "Log"}, func() {
 
 ## 状态
 
-- 内容溢出时区域可获得焦点，键盘焦点环画在区域内侧（2 DIP，Focus 色），避免被父级裁剪。
+- 内容溢出时区域可获得焦点，键盘焦点环画在区域内侧：先留 2 DIP 间隔，再画 2 DIP Focus 色环线，避免被父级裁剪。溢出状态在布局后变化时组件立即重建，焦点停靠随之更新。
 - 不溢出时不进入 Tab 序列。
 - 滚动条为 MyGo 叠加式滑块，颜色取主题 Scrollbar（TextMuted 50%），指针悬停时显示，不占布局空间。
 - 切换主题、折叠周围布局都不重置位置。

docs/components/009-aspect-ratio.md

@@ -38,4 +38,4 @@ ui.Box(c).Size(320, 240).Children(func() {
 ## 限制
 
 - 父级高度不确定（随内容增长）时只按宽度计算。
-- 框尺寸依据上一帧的父级尺寸计算，窗口缩放后组件请求下一帧完成调整（MyGo 布局的 `AspectRatio` 只能由宽推高，不能同时受宽高约束）。
+- 框尺寸依据上一帧的父级尺寸计算，窗口缩放后组件请求下一帧完成调整（MyGo 布局的 `AspectRatio` 由已定的宽推出高，或由固定的高推出宽，见 `ui/layout.go:345` 与 `:364`；但不会在父级宽高同时约束时取两者中较小的一边，因此组件自行计算）。