iter(g08): 新增 segmented 分段控制器组件

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T02:16:50.161Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T02:20:07.266Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -923,6 +923,33 @@ timeline({ items: [{ title: '提交审批', time: '09:12', variant: 'success' },
 
 现场演示：apps/docs/demo.html#sec-timeline
 
+### segmented — 分段控制器 Segmented
+
+参数：
+
+- options（必填）：OptionItem[] —— 分段选项列表（互斥），每项含 value / label / disabled
+- value（必填）：Signal<string> —— 当前选中值信号，双向绑定（点击写回，外部赋值即同步滑块）
+- size（默认 md）：'sm' | 'md' —— 尺寸档位；缺省 md
+- disabled：boolean | Signal<boolean> —— 整组禁用：布尔直接置位，传信号则动态同步；单项禁用走 options[].disabled
+- onChange（回调）：(value: string) => void —— 切换回调（禁用项与重复点击当前项都不触发）
+
+示例：
+
+```
+segmented({ options: [{ value: 'day', label: '日' }, { value: 'week', label: '周' }], value: range })
+```
+
+手把手：
+
+1. 和 tabs 的分工：tabs 是页签（下划线指示条 + 面板语义），segmented 是紧凑互斥切换（视图 / 单位 / 时间粒度）
+2. value 必须传信号：点击写回信号，外部改信号滑块自动平移，不要在回调里另存一份状态
+3. options[].disabled 置灰单项；disabled 传布尔或信号则整组失效（连滑块一起置灰）
+4. 键盘：←→ 在可用项间环形移动并选中，Tab 只落在当前项上（漫游 tabindex）
+5. 滑块几何由组件测量按钮位置得到，不要在外部改按钮宽度 / 内边距，否则需自行重渲染
+6. 需要带图标或更复杂布局的分段，改用 radioGroup + 自定义样式
+
+现场演示：apps/docs/demo.html#sec-segmented
+
 API 速览：
 
 - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用
@@ -961,6 +988,7 @@ API 速览：
 - dataTable(props)：数据表格，粘性表头 / 行选择（全选三态）/ 排序 / 筛选 / 分页 / 空状态；loading 为真时数据行换骨架行且筛选/翻页禁用，内核为 table-core
 - image(props)：图片，缩略图点击 / 回车开遮罩大图预览（Esc 或点击遮罩关闭），width 控制缩略宽
 - timeline(props)：时间线，items 按序渲染纵向事件流（标题 / 时间 / 正文 + 语义色节点），mode 控制轴线左右，pending 追加进行中节点
+- segmented(props)：分段控制器，胶囊分段 + 滑动滑块，value 信号双向绑定，←→ 环形导航，整组或单项可禁用
 
 一行用法：