fix: detect Dart SDK behind Flutter wrappers by RSS1102 · Pull Request #26 · TDesignOteam/tdesign-flutter-tools

RSS1102 · 2026-09-02T06:55:50Z

问题

在 macOS/Linux 使用 Flutter 或 FVM 提供的 bin/dart 运行 API 文档生成器时，SDK 检测会把 Flutter 根目录误认为 Dart SDK：

Detected Dart SDK: /Users/rs/fvm/default
PathNotFoundException: .../lib/_internal/sdk_library_metadata/lib/libraries.dart

生成器随后仍可能继续生成文件并返回成功，使异常容易被误判为无害日志。

根因

POSIX 的 which dart 分支只检查独立 Dart SDK 的 lib/_internal，没有像 Windows 分支一样识别 Flutter/FVM 的 bin/cache/dart-sdk。同时，显式 DART_SDK 未验证目录结构。

修改

提取内部 DartSdkDetector，统一 SDK 定位与结构校验。
支持 DART_SDK、FLUTTER_ROOT / FLUTTER_HOME、Windows where dart、POSIX which dart 和当前 executable 回退。
Flutter/FVM wrapper 优先解析到 bin/cache/dart-sdk。
无效环境变量不再直接传给 analyzer。
增加 FVM wrapper 与无效 DART_SDK 回退测试。

验证

dart analyze：通过，0 issues。
新增 SDK 检测测试：2 个通过。
除既有 ctor_defaults_test.dart 外的其余 39 个测试通过。
ctor_defaults_test.dart 的 TPopupOptions 用例在未修改的 main@5c1d464 上同样失败，与本 PR 无关。
使用原始 FVM PATH 复跑实际生成命令，能够识别 /Users/rs/fvm/default/bin/cache/dart-sdk，无 analyzer SDK 异常并成功生成文档。

github-actions · 2026-09-02T06:59:05Z

✅ 编译完成，产物如下：

api_tool_macos_intel（job: build-macos-intel）
api_tool_macos_arm64（job: build-macos-arm64）
api_tool_linux（job: build-linux-x64）
api_tool_windows（job: build-windows-x64）

在 Actions 运行页 Artifacts 区域按平台名称下载。

github-actions · 2026-09-02T06:59:33Z

文档变更

tdesign-component/example/assets/api/action_sheet_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/action_sheet_api.md	2026-09-02 06:57:41.280869038 +0000
@@ -0,0 +1,76 @@
+## API
+### TActionSheet
+
+#### 静态方法
+
+##### TActionSheet.showGrid
+
+显示宫格动作面板
+
+返回类型：`TPopupHandle`
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| context | BuildContext | - | 用于查找承载弹层的 Navigator。 |
+| items | List<TActionSheetItem> | - | 宫格中的动作项目。 |
+| align | TActionSheetAlign? | - | 项目对齐方式。 |
+| cancelText | String? | - | 取消按钮文字。 |
+| subtitle | String? | - | 面板副标题。 |
+| showCancel | bool | true | 是否显示取消按钮。 |
+| showOverlay | bool | true | 是否显示蒙层。 |
+| closeOnOverlayClick | bool | true | 点击蒙层是否关闭。 |
+| useSafeArea | bool | true | 是否避让系统安全区。 |
+| showPagination | bool | false | 是否显示分页指示器。 |
+| scrollable | bool | false | 是否允许滚动。 |
+| count | int? | - | 每页项目数。 |
+| rows | int? | - | 宫格行数。 |
+| itemHeight | double? | - | 项目高度。 |
+| itemMinWidth | double? | - | 项目最小宽度。 |
+| onCancel | VoidCallback? | - | 点击取消时回调。 |
+| onClosed | VoidCallback? | - | 面板关闭后回调。 |
+| onChanged | TActionSheetOnChanged? | - | 点击动作时回调。 |
+
+
+##### TActionSheet.showGroup
+
+显示分组动作面板
+
+返回类型：`TPopupHandle`
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| context | BuildContext | - | 用于查找承载弹层的 Navigator。 |
+| items | List<TActionSheetItem> | - | 分组中的动作项目。 |
+| align | TActionSheetAlign? | - | 项目对齐方式。 |
+| cancelText | String? | - | 取消按钮文字。 |
+| showCancel | bool | true | 是否显示取消按钮。 |
+| showOverlay | bool | true | 是否显示蒙层。 |
+| closeOnOverlayClick | bool | true | 点击蒙层是否关闭。 |
+| useSafeArea | bool | true | 是否避让系统安全区。 |
+| itemHeight | double? | - | 项目高度。 |
+| itemMinWidth | double? | - | 项目最小宽度。 |
+| onCancel | VoidCallback? | - | 点击取消时回调。 |
+| onClosed | VoidCallback? | - | 面板关闭后回调。 |
+| onChanged | TActionSheetOnChanged? | - | 点击动作时回调。 |
+
+
+##### TActionSheet.showList
+
+显示列表动作面板
+
+返回类型：`TPopupHandle`
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| context | BuildContext | - | 用于查找承载弹层的 Navigator。 |
+| items | List<TActionSheetItem> | - | 列表中的动作项目。 |
+| align | TActionSheetAlign? | - | 项目文字对齐方式。 |
+| cancelText | String? | - | 取消按钮文字。 |
+| subtitle | String? | - | 面板副标题。 |
+| showCancel | bool | true | 是否显示取消按钮。 |
+| showOverlay | bool | true | 是否显示蒙层。 |
+| closeOnOverlayClick | bool | true | 点击蒙层是否关闭。 |
+| useSafeArea | bool | true | 是否避让系统安全区。 |
+| onCancel | VoidCallback? | - | 点击取消时回调。 |
+| onClosed | VoidCallback? | - | 面板关闭后回调。 |
+| onChanged | TActionSheetOnChanged? | - | 点击动作时回调。 |

tdesign-component/example/assets/api/backtop_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/backtop_api.md	2026-09-02 06:57:41.695549429 +0000
@@ -0,0 +1 @@
+## API

tdesign-component/example/assets/api/calendar_api.md

diff --git a/tdesign-component/example/assets/api/calendar_api.md b/tdesign-component/example/assets/api/calendar_api.md
index fdd1afe..5df3a12 100644
--- a/tdesign-component/example/assets/api/calendar_api.md
+++ b/tdesign-component/example/assets/api/calendar_api.md
@@ -17,79 +17,3 @@
 | subtitleBuilder | TCalendarSubtitleBuilder? | - | 日期副标题构建器。 |
 | value | List<DateTime> | - | 受控选中日期列表。 列表长度与 `variant` 对应： - `TCalendarVariant.single`：1 个元素（选中日期） - `TCalendarVariant.multiple`：N 个元素（所有选中日期） - `TCalendarVariant.range`：2 个元素（起始、结束日期） |
 | variant | TCalendarVariant | TCalendarVariant.single | 选择模式。 |
-
-
-### TCalendarStyle
-
-#### 静态方法
-
-##### TCalendarStyle.generateStyle
-
-生成默认样式
-
-返回类型：`TCalendarStyle`
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| context | BuildContext? | - | - |
-
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| bodyPadding | double? | - | 内边距 |
-| cellDecoration | BoxDecoration? | - | 日期单元格装饰（选中状态） |
-| cellHeight | double | 60 | 日期单元格高度，默认 60 |
-| centreColor | Color? | - | 区间中间格背景与格间衔接条颜色。 |
-| dayStyle | TextStyle? | - | 日期数字样式 |
-| decoration | BoxDecoration? | - | 组件容器装饰 |
-| monthTitleHeight | double | 22 | 月份标题高度，默认 22 |
-| monthTitleStyle | TextStyle? | - | 月份标题文字样式 |
-| subtitleStyle | TextStyle? | - | 副标题样式 |
-| todayDayStyle | TextStyle? | - | 今天日期数字样式 |
-| verticalGap | double? | - | 日期格垂直间距，水平间距为 `verticalGap` / 2 |
-| weekdayGap | double? | - | 星期之间的水平间距 |
-| weekdayStyle | TextStyle? | - | 星期文字样式 |
-
-
-### TCalendarCellModel
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| date | DateTime | - | 当前日期。 |
-| isLastDayOfMonth | bool | - | 是否为当月最后一天。 |
-| typeNotifier | DateSelectTypeNotifier | - | 日期选择状态通知器。 |
-
-
-### TCalendarSubtitleContext
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| date | DateTime | - | 当前格子的阳历日期（仅年月日，无时分秒）。 |
-| selectType | DateSelectType | - | 当前格的选中/区间/禁用等展示状态，便于按态设置副标题样式。 |
-
-
-### TCalendarSubtitleBuilder
-#### 类型定义
-
-```dart
-typedef TCalendarSubtitleBuilder = Widget? Function(BuildContext context, TCalendarSubtitleContext subtitleContext);
-```
-
-
-### TCalendarCellBuilder
-#### 类型定义
-
-```dart
-typedef TCalendarCellBuilder = Widget? Function(BuildContext context, TCalendarCellModel cell);
-```
-
-
-### TCalendarMonthTitleBuilder
-#### 类型定义
-
-```dart
-typedef TCalendarMonthTitleBuilder = Widget Function(BuildContext context, DateTime monthDate);
-```

tdesign-component/example/assets/api/cascader_api.md

diff --git a/tdesign-component/example/assets/api/cascader_api.md b/tdesign-component/example/assets/api/cascader_api.md
index ac083b0..52b5491 100644
--- a/tdesign-component/example/assets/api/cascader_api.md
+++ b/tdesign-component/example/assets/api/cascader_api.md
@@ -1 +1,12 @@
 ## API
+### TCascader
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
+| onChanged | ValueChanged<List<Object?>>? | - | 选中路径变化回调；为 null 时禁用。 |
+| options | List<TCascaderOption> | - | 根选项列表。 |
+| placeholder | String | '请选择' | 未选择层级的占位文案。 |
+| value | List<Object?> | - | 受控选中路径。 |
+| variant | TCascaderVariant | TCascaderVariant.tab | 导航展示形态。 |

tdesign-component/example/assets/api/cell_api.md

diff --git a/tdesign-component/example/assets/api/cell_api.md b/tdesign-component/example/assets/api/cell_api.md
index 582308b..485b4a3 100644
--- a/tdesign-component/example/assets/api/cell_api.md
+++ b/tdesign-component/example/assets/api/cell_api.md
@@ -1,7 +1,5 @@
 ## API
 ### TCell
-#### 简介
-单元格组件。
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -21,24 +19,7 @@
 | trailing | Widget? | - | 最右侧内容。 |
 
 
-### TCellGroup
-#### 简介
-单元格组。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| builder | TCellGroupBuilder? | - | 自定义单元格外层构建器。 |
-| cells | List<TCell> | - | 单元格列表。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| scrollable | bool | false | 是否使用可滚动列表。 |
-| title | Widget? | - | 组标题。 |
-| variant | TCellGroupVariant? | - | 组视觉形态；未设置时读取 Theme。 |
-
-
 ### TCellAlign
-#### 简介
-单元格内容垂直对齐方式。
 #### 枚举值
 
 
@@ -47,13 +28,3 @@
 | top | 顶部对齐。 |
 | center | 居中对齐。 |
 | bottom | 底部对齐。 |
-
-
-### TCellGroupBuilder
-#### 简介
-单元格包装构建器。
-#### 类型定义
-
-```dart
-typedef TCellGroupBuilder = Widget Function(BuildContext context, TCell cell, int index);
-```

tdesign-component/example/assets/api/collapse_api.md

diff --git a/tdesign-component/example/assets/api/collapse_api.md b/tdesign-component/example/assets/api/collapse_api.md
index 4145533..30f7373 100644
--- a/tdesign-component/example/assets/api/collapse_api.md
+++ b/tdesign-component/example/assets/api/collapse_api.md
@@ -1,7 +1,5 @@
 ## API
 ### TCollapse
-#### 简介
-折叠面板列表组件，需配合 `TCollapsePanel` 使用
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |

tdesign-component/example/assets/api/date_time_picker_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/date_time_picker_api.md	2026-09-02 06:57:41.831778043 +0000
@@ -0,0 +1,15 @@
+## API
+### TDateTimePicker
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| end | TDateTimePickerValue? | - | 可选范围上限 - **类型**：`TDateTimePickerValue`，仅传当前 mode 涉及的字段即可 - **语义**：超出范围的候选项会被裁剪；变更会触发列重建 |
+| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
+| mode | DateTimePickerMode? | - | 滚轮列结构（必填） - **类型**：`DateTimePickerMode`，通过 `DateMode`、`TimeMode` 组合列 - **默认**：未传时等价于 `DateTimePickerMode(dateMode: DateMode.date)`（年月日） - **变更语义**：列结构变化会重建滚轮并清空上次通知值 |
+| onChanged | void Function(TDateTimePickerValue result)? | - | 选中值变化回调（滚动时实时触发，不代表用户已确认选择） - **触发时机**：滚轮选中变化且结果与上次通知值不同时 - **返回值**：`TDateTimePickerValue`；不含的列字段为 null - **典型用法**：维护业务侧受控状态 |
+| renderLabel | DateTimePickerRenderLabel? | - | 自定义列展示文案 - **回调参数**：`column` 为 `DateTimeColumn`，`value` 为列数值 - **回退**：返回 null 时使用内置默认文案（含国际化单位后缀） |
+| showWeek | bool | false | 日列是否在 label 后附加星期，默认 false - **生效范围**：仅 `DateTimeColumn.day` 列 - **变更语义**：变更会触发列重建 |
+| start | TDateTimePickerValue? | - | 可选范围下限 - **类型**：`TDateTimePickerValue`，仅传当前 mode 涉及的字段即可 - **语义**：超出范围的候选项会被裁剪；变更会触发列重建 |
+| steps | DateTimePickerSteps? | - | 各列选项步进 - **类型**：`DateTimePickerSteps`；未配置的列步进为 1 - **变更语义**：变更会触发列重建，保留当前选中时刻（在合法范围内 clamp） |
+| value | TDateTimePickerValue | - | 受控选中值。 |

tdesign-component/example/assets/api/dialog_api.md

diff --git a/tdesign-component/example/assets/api/dialog_api.md b/tdesign-component/example/assets/api/dialog_api.md
index 3b44399..21d77f2 100644
--- a/tdesign-component/example/assets/api/dialog_api.md
+++ b/tdesign-component/example/assets/api/dialog_api.md
@@ -39,75 +39,6 @@
 | width | double? | - | 面板宽度。 |
 
 
-### TDialogAction
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| child | Widget | - | 按钮内容。 |
-| closeOnPressed | bool | true | 点击后是否自动关闭。 |
-| colorScheme | TButtonColorScheme? | - | 显式按钮配色。 |
-| disabled | bool | false | 是否禁用。 |
-| onPressed | VoidCallback? | - | 点击回调，在自动关闭前执行。 |
-| result | Object? | - | 关闭 Dialog 时返回的结果。 |
-| role | TDialogActionRole | TDialogActionRole.normal | 操作语义角色。 |
-| style | ButtonStyle? | - | 显式按钮样式。 |
-| variant | TButtonVariant? | - | 显式按钮变体。 |
-
-
-### TConfirmDialog
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| backgroundColor | Color? | - | - |
-| buttonStyle | ButtonStyle? | - | - |
-| buttonText | String? | - | - |
-| closeOnPressed | bool | true | - |
-| content | String? | - | - |
-| contentPadding | EdgeInsetsGeometry? | - | - |
-| contentWidget | Widget? | - | - |
-| elevation | double? | - | - |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| maxHeight | double? | - | - |
-| onPressed | VoidCallback? | - | - |
-| result | Object? | true | - |
-| semanticLabel | String? | - | - |
-| shape | ShapeBorder? | - | - |
-| showCloseButton | bool | false | - |
-| title | String? | - | - |
-| width | double? | - | - |
-
-
-### TDialogThemeData
-
-#### 静态方法
-
-##### TDialogThemeData.lerpDouble
-
-返回类型：`double?`
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| a | double? | - | - |
-| b | double? | - | - |
-| t | double | - | - |
-
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| actionButtonStyle | ButtonStyle? | - | 按钮区样式（对应 Material `TextButtonThemeData`；TDesign 扩展） |
-| backgroundColor | Color? | - | 背景色（对应 Material `DialogThemeData.backgroundColor`） |
-| contentPadding | EdgeInsetsGeometry? | - | 内容内边距（对应 Material `Dialog` 的 contentPadding；TDesign 扩展） |
-| contentTextStyle | TextStyle? | - | 内容文案样式（对应 Material `DialogThemeData.contentTextStyle`） |
-| elevation | double? | - | 阴影（对应 Material `DialogThemeData.elevation`） |
-| maxHeight | double? | - | 面板最大高度。 |
-| shape | ShapeBorder? | - | 形状（圆角；对应 Material `DialogThemeData.shape`） |
-| titleTextStyle | TextStyle? | - | 标题文案样式（对应 Material `DialogThemeData.titleTextStyle`） |
-| width | double? | - | 弹窗宽度 |
-
-
 ### TDialogActionRole
 #### 枚举值

tdesign-component/example/assets/api/drawer_api.md

diff --git a/tdesign-component/example/assets/api/drawer_api.md b/tdesign-component/example/assets/api/drawer_api.md
index 3ef9877..0fecd10 100644
--- a/tdesign-component/example/assets/api/drawer_api.md
+++ b/tdesign-component/example/assets/api/drawer_api.md
@@ -1,7 +1,5 @@
 ## API
 ### TDrawer
-#### 简介
-抽屉组件
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -21,42 +19,7 @@
 | width | double? | - | 宽度（优先级高于 ThemeData） |
 
 
-### TDrawerWidget
-#### 简介
-抽屉内容组件
-可用于 Scaffold 中的 drawer 属性
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| backgroundColor | Color? | - | 组件背景颜色 |
-| bordered | bool? | - | 是否显示边框 |
-| child | Widget? | - | 自定义内容，优先级高于`items`/`footer`/`title` |
-| footer | Widget? | - | 抽屉的底部 |
-| hover | bool? | - | 是否开启点击反馈 |
-| isShowLastBordered | bool? | - | 是否显示最后一行分割线 |
-| items | List<TDrawerItem>? | - | 抽屉里的列表项 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| onItemClick | TDrawerItemClickCallback? | - | 点击抽屉里的列表项触发 |
-| title | Widget? | - | 抽屉的标题组件 |
-| width | double? | - | 宽度 |
-
-
-### TDrawerItem
-#### 简介
-抽屉里的列表项
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| content | Widget? | - | 完全自定义 |
-| icon | Widget? | - | 每列图标 |
-| title | String? | - | 每列标题 |
-
-
 ### TDrawerPlacement
-#### 简介
-抽屉方向
 #### 枚举值
 
 
@@ -64,14 +27,3 @@
 | --- | --- |
 | left | 从左侧滑出 |
 | right | 从右侧滑出 |
-
-
-### TDrawerItemClickCallback
-#### 简介
-点击抽屉列表项时的回调。
-`index` 是列表下标，`item` 是被点击的配置项。
-#### 类型定义
-
-```dart
-typedef TDrawerItemClickCallback = void Function(int index, TDrawerItem item);
-```

tdesign-component/example/assets/api/dropdown_menu_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/dropdown_menu_api.md	2026-09-02 06:57:40.879868082 +0000
@@ -0,0 +1,68 @@
+## API
+### TDropdownMenu
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| animationDuration | Duration | const Duration(milliseconds: 200) | - |
+| closeOnOverlayTap | bool | true | - |
+| controller | TDropdownMenuController? | - | - |
+| items | List<TDropdownMenuItem> | - | - |
+| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
+| onClosed | TDropdownMenuClosedCallback? | - | - |
+| onOpened | ValueChanged<int>? | - | - |
+| placement | TDropdownMenuPlacement | TDropdownMenuPlacement.auto | - |
+| scrollable | bool | false | - |
+| showOverlay | bool | true | - |
+| useRootOverlay | bool | false | - |
+
+
+### TDropdownMenuPlacement
+#### 枚举值
+
+
+| 名称 | 说明 |
+| --- | --- |
+| auto | - |
+| below | - |
+| above | - |
+
+
+### TDropdownMenuCloseReason
+#### 枚举值
+
+
+| 名称 | 说明 |
+| --- | --- |
+| selection | - |
+| confirm | - |
+| cancel | - |
+| overlay | - |
+| back | - |
+| trigger | - |
+| controller | - |
+| switchItem | - |
+
+
+### TDropdownMenuClosedCallback
+#### 类型定义
+
+```dart
+typedef TDropdownMenuClosedCallback = void Function(int index, TDropdownMenuCloseReason reason);
+```
+
+
+### TDropdownMenuPanelBuilder
+#### 类型定义
+
+```dart
+typedef TDropdownMenuPanelBuilder = Widget Function(BuildContext context, TDropdownMenuPanelController controller);
+```
+
+
+### TDropdownMenuTriggerBuilder
+#### 类型定义
+
+```dart
+typedef TDropdownMenuTriggerBuilder = Widget Function(BuildContext context, TDropdownMenuTriggerState state);
+```

tdesign-component/example/assets/api/form_api.md

diff --git a/tdesign-component/example/assets/api/form_api.md b/tdesign-component/example/assets/api/form_api.md
index 7f08ec3..d93981a 100644
--- a/tdesign-component/example/assets/api/form_api.md
+++ b/tdesign-component/example/assets/api/form_api.md
@@ -1,8 +1,5 @@
 ## API
 ### TForm
-#### 简介
-TDesign 表单容器。
-校验和字段生命周期委托给 Flutter `Form` 与 `FormState`。
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -16,133 +13,7 @@ TDesign 表单容器。
 | showErrorMessage | bool | true | 是否向字段 builder 暴露错误文案。 |
 
 
-### TFormState
-#### 简介
-`TForm` 的公开状态。
-
-### TFormController
-#### 简介
-命令式触发表单提交、校验和重置。
-
-### TFormField
-#### 简介
-将严格受控组件接入 Flutter `FormField` 的字段桥接组件。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| autovalidateMode | AutovalidateMode? | - | 自动校验时机；为空时继承 `TForm`。 |
-| builder | TFormFieldBuilder<T> | - | 字段内容 builder。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| name | String | - | 字段名。 |
-| onChanged | ValueChanged<T>? | - | 字段值变化回调；为 null 时禁用字段。 |
-| onSaved | FormFieldSetter<T>? | - | 保存字段时触发。 |
-| required | bool | false | 是否执行内置必填校验，并让表单项默认显示必填标记。 |
-| requiredMessage | String | '此项不能为空' | 内置必填校验失败时的错误文案。 |
-| validator | FormFieldValidator<T>? | - | 字段校验器。 |
-| value | T | - | 受控字段值。 |
-
-
-### TFormItem
-#### 简介
-表单项的标签和字段布局容器。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| child | Widget | - | 字段内容。 |
-| contentAlignment | TFormItemContentAlignment? | - | 内容区域的水平方向对齐方式。 未传时读取 `TFormThemeData.contentAlignment`，默认起始侧对齐；影响 字段控件、help 和 error 的外部位置，不影响输入文本自身的对齐方式。 |
-| errorText | String? | - | 错误文案。 未传时自动使用最近 `TFormField` 的校验错误。 |
-| extra | Widget? | - | 表单项尾部的额外内容。 该插槽不会被附加内边距、位移或固定尺寸。 |
-| help | String? | - | 辅助说明文案。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| label | String? | - | 标签文案。 |
-| labelAlign | TextAlign? | - | 标签文本对齐方式；为空时读取 `TFormThemeData.labelAlign`。 |
-| labelWidth | double? | - | 标签区域宽度；为空时读取 `TFormThemeData.labelWidth`，默认 80dp。 |
-| leading | Widget? | - | 标签区域前的内容，通常用于字段行图标。 该插槽属于表单项结构，不会传入输入组件的编辑内容区域。 |
-| required | bool? | - | 是否显示必填标记；仅覆盖展示效果，不会启用或关闭 `TFormField.required` 的校验行为。 未传时继承最近 `TFormField` 的 required 状态。 |
-| showErrorMessage | bool | true | 是否展示继承的校验错误。 |
-| verticalAlignment | TFormItemVerticalAlignment? | - | 水平布局下标签、字段内容和额外内容的纵向对齐方式。 未传时读取 `TFormThemeData.verticalAlignment`，默认顶部对齐。 |
-
-
-### TFormThemeData
-#### 简介
-TForm 组件级 ThemeExtension。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| backgroundColor | Color? | - | 表单项背景色。 |
-| borderColor | Color? | - | 表单项底部分隔线颜色。 |
-| contentAlignment | TFormItemContentAlignment? | - | 表单项内容区域的水平方向对齐方式。 |
-| errorStyle | TextStyle? | - | 错误文案样式。 |
-| helpStyle | TextStyle? | - | 辅助说明样式。 |
-| itemPadding | EdgeInsetsGeometry? | - | 表单项内边距。 |
-| itemSpacing | double? | - | 表单项间距。 |
-| labelAlign | TextAlign? | - | 标签对齐方式；默认左对齐。 |
-| labelGap | double? | - | 标签与字段的垂直间距。 |
-| labelStyle | TextStyle? | - | 标签样式。 |
-| labelWidth | double? | - | 默认标签宽度。 |
-| layout | TFormLayout? | - | 表单项布局方向。 |
-| leadingGap | double? | - | 前置内容与标签区域的间距。 |
-| messageGap | double? | - | 字段与辅助或错误文案的间距。 |
-| requiredMarkPosition | TFormRequiredMarkPosition? | - | 必填标记位置。 |
-| requiredMarkStyle | TextStyle? | - | 必填标记样式。 |
-| showColon | bool? | - | 是否在标签末尾显示冒号。 |
-| verticalAlignment | TFormItemVerticalAlignment? | - | 水平表单项各区域的纵向对齐方式。 |
-
-
-### TFormLayout
-#### 简介
-表单项布局方向。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| horizontal | 标签与字段水平排列。 |
-| vertical | 标签与字段垂直排列。 |
-
-
-### TFormRequiredMarkPosition
-#### 简介
-表单必填标记的位置。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| left | 显示在标签左侧。 |
-| right | 显示在标签右侧。 |
-
-
-### TFormItemVerticalAlignment
-#### 简介
-水平表单项各区域的纵向对齐方式。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| start | 标签、字段内容和额外内容从顶部对齐。 |
-| center | 标签、字段内容和额外内容垂直居中。 |
-
-
-### TFormItemContentAlignment
-#### 简介
-表单项内容区域的水平方向对齐方式。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| start | 内容靠起始侧对齐。 |
-| end | 内容靠结束侧对齐。 |
-
-
 ### TFormFieldBuilder
-#### 简介
-TDesign 字段 builder。
 #### 类型定义
 
 ```dart

tdesign-component/example/assets/api/icon_api.md

diff --git a/tdesign-component/example/assets/api/icon_api.md b/tdesign-component/example/assets/api/icon_api.md
index 0376e61..b26d626 100644
--- a/tdesign-component/example/assets/api/icon_api.md
+++ b/tdesign-component/example/assets/api/icon_api.md
@@ -1,12 +1,5 @@
 ## API
 ### TIcon
-#### 简介
-TIcon 图标组件
-Material `Icon` 的薄包装，提供 TDesign 默认颜色和组件级 Theme 注入能力。
-图标数据由 `tdesign_flutter_icons` 资源包提供，通过 `TIcons.xxx` 常量引用。
-优先级链：
-构造器参数 > `TIconThemeData` > `IconTheme` > ThemeData.iconTheme >
-TDesign token 颜色兜底。
 
 #### 工厂构造方法
 
@@ -32,17 +25,3 @@ TDesign token 颜色兜底。
 | key | Key? | - | 组件标识，用于区分或保留组件状态。 |
 | semanticLabel | String? | - | 无障碍语义标签。 非空时由原生 `Icon` 暴露给辅助技术；为空时图标不单独提供语义节点。 |
 | size | double? | - | 图标尺寸，单位为逻辑像素。 未设置时依次读取 `TIconThemeData.size`、显式 `IconTheme`，最后由 Flutter 原生 `Icon` 使用其默认尺寸。 |
-
-
-### TIconThemeData
-#### 简介
-TIcon 组件级 ThemeExtension
-通过 Material Theme 子树注入，控制 `TIcon` 的默认尺寸和颜色。
-未配置的字段继续回退显式 `IconTheme` 和 TDesign Token，不会覆盖其它组件主题。
-`TIcon` 构造器参数始终具有最高优先级。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| color | Color? | - | 图标默认颜色；为空时回退显式 `IconTheme`，最终回退 `textColorPrimary` Token。 |
-| size | double? | - | 图标默认尺寸，单位为逻辑像素；为空时回退显式 `IconTheme`。 |

tdesign-component/example/assets/api/image_viewer_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/image_viewer_api.md	2026-09-02 06:57:41.557869698 +0000
@@ -0,0 +1,39 @@
+## API
+### TImageViewer
+
+#### 静态方法
+
+##### TImageViewer.show
+
+显示全屏图片预览。
+
+返回类型：`Future<void>`
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| context | BuildContext | - | 用于展示预览弹窗。 |
+| images | List<ImageProvider<Object>> | - | 是待预览的图片列表，不能为空。 |
+| labels | List<String>? | - | 是与图片一一对应的标签文案。 |
+| initialIndex | int | 0 | 设置初始展示的图片索引。 |
+| showClose | bool | true | 控制关闭按钮是否显示。 |
+| showDelete | bool | false | 控制删除按钮是否显示。 |
+| showIndex | bool | true | 控制当前页码是否显示。 |
+| loop | bool | false | 控制是否循环切换图片。 |
+| autoplay | bool | false | 控制是否自动切换图片。 |
+| autoplayInterval | Duration | const Duration(seconds: 3) | 设置自动切换图片的时间间隔。 |
+| barrierDismissible | bool | true | 控制点击弹窗外区域时是否关闭预览。 |
+| onIndexChanged | ValueChanged<int>? | - | 在当前图片索引变化时触发。 |
+| onClose | VoidCallback? | - | 在预览关闭时触发。 |
+| onDelete | ValueChanged<int>? | - | 在点击删除按钮时触发，仅通知当前索引。 |
+| onTap | ValueChanged<int>? | - | 在点击当前图片时触发。 |
+| onLongPress | ValueChanged<int>? | - | 在长按当前图片时触发。 |
+| leadingBuilder | TImageViewerItemBuilder? | - | 构建导航栏起始区域。 |
+| trailingBuilder | TImageViewerItemBuilder? | - | 构建导航栏末尾区域。 |
+
+
+### TImageViewerItemBuilder
+#### 类型定义
+
+```dart
+typedef TImageViewerItemBuilder = Widget Function(BuildContext context, int index);
+```

tdesign-component/example/assets/api/indexes_api.md

diff --git a/tdesign-component/example/assets/api/indexes_api.md b/tdesign-component/example/assets/api/indexes_api.md
index 9453ce7..920813b 100644
--- a/tdesign-component/example/assets/api/indexes_api.md
+++ b/tdesign-component/example/assets/api/indexes_api.md
@@ -1,7 +1,5 @@
 ## API
 ### TIndexes
-#### 简介
-索引
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -19,33 +17,3 @@
 | scrollController | ScrollController? | - | 滚动控制器 |
 | sticky | bool? | - | 锚点是否吸顶（优先级高于 ThemeData） |
 | stickyOffset | double? | - | 锚点吸顶时与顶部的距离（优先级高于 ThemeData） |
-
-
-### TIndexesAnchor
-#### 简介
-索引锚点
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| activeIndex | ValueNotifier<String> | - | 选中索引 |
-| builderAnchor | Widget? Function(BuildContext context, String index, bool isPinnedToTop)? | - | 索引锚点构建 |
-| capsuleTheme | bool | - | 是否为胶囊式样式 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| sticky | bool | - | 索引是否吸顶 |
-| text | String | - | 锚点文本 |
-
-
-### TIndexesList
-#### 简介
-索引
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| activeIndex | ValueNotifier<String> | - | 选中索引 |
-| builderIndex | Widget Function(BuildContext context, String index, bool isActive)? | - | 索引文本自定义构建，包括索引激活左侧提示 |
-| indexList | List<String> | - | 索引字符列表。不传默认 A-Z |
-| indexListMaxHeight | double | 0.8 | 索引列表最大高度（父容器高度的百分比，默认0.8） |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| onSelect | void Function(String newIndex, String oldIndex) | - | 点击侧边栏时触发事件 |

tdesign-component/example/assets/api/notice_bar_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/notice_bar_api.md	2026-09-02 06:57:41.331735462 +0000
@@ -0,0 +1,31 @@
+## API
+### TNoticeBar
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| content | String | '' | 单条公告内容。 当 `items` 非空时不显示此内容。 |
+| direction | Axis | Axis.horizontal | 滚动方向 |
+| interval | Duration | const Duration(seconds: 2) | 垂直轮播的切换间隔，仅在 `direction` 为 `Axis.vertical` 时生效。 |
+| items | List<String> | const <String>[] | 多条公告内容，主要用于垂直轮播。 非空时作为内容数据源，并优先于 `content`。 |
+| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
+| marquee | bool | false | 是否启用横向跑马灯展示。 |
+| maxLines | int | 1 | 文本行数（仅静态有效） |
+| onPressed | ValueChanged<TNoticeBarTapTarget>? | - | 点击事件 |
+| operation | Widget? | - | 内容右侧、`suffixIcon` 左侧的自定义操作区。 可以和 `suffixIcon` 同时显示。 |
+| prefix | Widget? | - | 自定义前缀区域。 为 null 时根据 `status` 显示默认图标；传入 `SizedBox.shrink` 可隐藏 前缀区域。自定义内容负责该区域的间距；其中未显式指定颜色或尺寸的 `Icon` 会继承公告栏的状态图标颜色和标准图标尺寸。 |
+| speed | double | 50 | 横向跑马灯每秒滚动的逻辑像素，仅在 `direction` 为 `Axis.horizontal` 且 `marquee` 为 true 时生效。 |
+| status | TNoticeBarStatus | TNoticeBarStatus.info | 公告栏业务状态，决定默认配色和默认前缀图标。 |
+| suffixIcon | IconData? | - | 尾部图标，可以和 `operation` 同时显示。 |
+
+
+### TNoticeBarTapTarget
+#### 枚举值
+
+
+| 名称 | 说明 |
+| --- | --- |
+| prefix | 前缀区域 |
+| content | 公告内容 |
+| operation | 右侧操作区 |
+| suffix | 尾部图标 |

tdesign-component/example/assets/api/picker_api.md

diff --git a/tdesign-component/example/assets/api/picker_api.md b/tdesign-component/example/assets/api/picker_api.md
index 348a9ac..b72d0f3 100644
--- a/tdesign-component/example/assets/api/picker_api.md
+++ b/tdesign-component/example/assets/api/picker_api.md
@@ -1,9 +1,5 @@
 ## API
 ### TPicker
-#### 简介
-严格受控的滚轮选择器。
-独立多列使用 `TPickerColumns`，层级联动使用 `TPickerLinked`。弹层和确认
-操作由调用方组合，组件本身只负责滚轮选择。
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -14,57 +10,3 @@
 | onChanged | ValueChanged<TPickerValue>? | - | 值变化回调；为 null 时禁用。 |
 | onColumnScrollEnd | void Function(int columnIndex, TPickerValue value)? | - | 某列滚动结束回调。 |
 | value | List<Object?> | - | 各列受控值。 |
-
-
-### TPickerOption
-#### 简介
-选择器选项。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| children | List<TPickerOption> | const [] | 联动模式下的子选项。 |
-| disabled | bool | false | 是否禁用。 |
-| label | String | - | 展示文案。 |
-| value | Object? | - | 业务值。 |
-
-
-### TPickerValue
-#### 简介
-各列当前选中项的只读快照。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| indexes | List<int> | - | 各列选中索引。 |
-| selectedOptions | List<TPickerOption> | - | 各列选中的完整选项。 |
-
-
-### TPickerColumns
-#### 简介
-互不联动的多列数据源。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| columns | List<List<TPickerOption>> | - | 各列选项。 |
-
-
-### TPickerLinked
-#### 简介
-由 `TPickerOption.children` 描述层级关系的联动数据源。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| options | List<TPickerOption> | - | 根选项。 |
-
-
-### TPickerItemBuilder
-#### 简介
-选择器子项构建器。
-#### 类型定义
-
-```dart
-typedef TPickerItemBuilder = Widget? Function(BuildContext context, TPickerOption option, int columnIndex, int itemIndex, double distance);
-```

tdesign-component/example/assets/api/popover_api.md

diff --git a/tdesign-component/example/assets/api/popover_api.md b/tdesign-component/example/assets/api/popover_api.md
index 6ece12b..a1370c8 100644
--- a/tdesign-component/example/assets/api/popover_api.md
+++ b/tdesign-component/example/assets/api/popover_api.md
@@ -1,8 +1,5 @@
 ## API
 ### TPopover
-#### 简介
-气泡弹层
-通过 `showPopover` 静态方法弹出，支持 12 个方向定位和箭头。
 
 #### 静态方法
 
@@ -30,41 +27,3 @@
 | onTap | VoidCallback? | - | 点击气泡内容时触发。 |
 | onLongTap | VoidCallback? | - | 长按气泡内容时触发。 |
 | radius | BorderRadius? | - | 气泡圆角。 |
-
-
-### TPopoverColorScheme
-#### 简介
-弹出气泡预设配色。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| defaultTheme | 默认深色配色。 |
-| light | 浅色。 |
-| primary | 品牌主色。 |
-| success | 成功。 |
-| warning | 警告。 |
-| danger | 危险色。 |
-
-
-### TPopoverPlacement
-#### 简介
-气泡弹层定位方向。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| topLeft | 上左。 |
-| top | 上方。 |
-| topRight | 上右。 |
-| rightTop | 右上。 |
-| right | 右侧。 |
-| rightBottom | 右下。 |
-| bottomRight | 下右。 |
-| bottom | 下方。 |
-| bottomLeft | 下左。 |
-| leftBottom | 左下。 |
-| left | 左侧。 |
-| leftTop | 左上。 |

tdesign-component/example/assets/api/popup_api.md

diff --git a/tdesign-component/example/assets/api/popup_api.md b/tdesign-component/example/assets/api/popup_api.md
index 6f264b1..d239049 100644
--- a/tdesign-component/example/assets/api/popup_api.md
+++ b/tdesign-component/example/assets/api/popup_api.md
@@ -1,12 +1,5 @@
 ## API
 ### TPopup
-#### 简介
-弹出层入口：五向滑入 / 居中弹出，支持蒙层、可选 bottom 头部和
-可选 center 面板外下方关闭区。
-通过 `show` 命令式打开；返回 `TPopupHandle` 用于关闭与再次打开。
-多次调用 `show` 会继续压入新的浮层路由，可用于叠加展示。
-
-配置项见 `TPopupOptions`；方向见 `TPopupPlacement`。
 
 #### 静态方法
 
@@ -25,266 +18,3 @@
 | options | TPopupOptions | - | 浮层配置；方向固定时推荐 `TPopupOptions.bottom` 等命名工厂。 |
 | navigatorContext | BuildContext? | - | 可选，指定承载浮层的 `Navigator` 的 context，默认 `context`。 |
 | useRootNavigator | bool | false | 为 true 时使用根 `Navigator`（嵌套导航场景）。 |
-
-
-### TPopupHeader
-#### 简介
-Popup 标准头部布局。
-本组件只负责取消按钮、标题和确认按钮的布局，不注入默认内容或业务行为。
-需要关闭 Popup 时，在 `TPopupOptions.headerBuilder` 中构建按钮并调用其 `close` 参数。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| cancelButton | Widget? | - | 左侧取消操作；为 null 时不显示。 |
-| confirmButton | Widget? | - | 右侧确认操作；为 null 时不显示。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| title | Widget? | - | 中间标题；为 null 时不显示。 |
-
-#### 静态成员
-
-| 名称 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| headerHeight | double | - | 标准头部高度。 |
-
-
-### TPopupOptions
-#### 简介
-`TPopup.show` 的配置对象。
-## 如何创建
-| 场景 | 推荐用法 |
-|------|----------|
-| 弹出方向已知 | `TPopupOptions.bottom`、`TPopupOptions.center`、`TPopupOptions.top`、`TPopupOptions.left`、`TPopupOptions.right` |
-| 方向由变量决定 | 默认构造并设置 `placement`；传错字段会在 `TPopup.show` / `TPopupHandle.open` 时抛 `FlutterError` |
-命名工厂只暴露当前方向生效的字段（例如 `TPopupOptions.bottom` 无 `width` 参数）。
-## 字段与 `TPopupPlacement`
-| `TPopupPlacement` | 头部 / 关闭区 | 尺寸 |
-|-------------------|-------------|------|
-| `TPopupPlacement.bottom` | `headerBuilder` | `height`、`inset` |
-| `TPopupPlacement.center` | `closeBuilder` | `width`、`height` |
-| `TPopupPlacement.top` | — | `height`、`inset` |
-| `TPopupPlacement.left`、`TPopupPlacement.right` | — | `width`、`inset` |
-`headerBuilder` 与 `closeBuilder` 默认均为 `null`，基础 Popup 只渲染
-`child`。显式提供 builder 时才会渲染相应区域，builder 可调用 `close`
-关闭浮层。
-生命周期回调见 `onOpened`、`onClosed`、`onVisibleChange`；
-蒙层行为见 `overlay`（`TPopupOverlayConfig`）。
-
-#### 工厂构造方法
-
-##### 通用参数
-
-以下参数由各命名工厂统一透传，含义一致：
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| animationDuration | Duration? | - | 打开/关闭动画时长，默认 240ms（与小程序公开 duration 默认值一致）。 |
-| backgroundColor | Color? | - | 内容区背景色，默认主题容器色。 |
-| child | Widget | - | 浮层主体内容（必填）。 |
-| destroyOnClose | bool | false | 为 true 时路由 `maintainState` 为 false，关闭后不保留路由内 State。 |
-| onClosed | VoidCallback? | - | 当前展示周期真正结束。 大多数场景下会在关闭动画结束后触发；非栈顶路由被直接移除时不保证存在关闭动画。 |
-| onOpened | VoidCallback? | - | 打开动画结束。 |
-| onVisibleChange | TPopupVisibleChangeCallback? | - | 显隐变化；第二个参数为 `TPopupTrigger`。 |
-| overlay | TPopupOverlayConfig? | - | 蒙层行为配置；为 null 时使用 `TPopupOverlayConfig` 默认值（标准模态弹层）。 |
-| radius | double? | - | 内容区圆角。 `TPopupPlacement.top`、`TPopupPlacement.bottom`、`TPopupPlacement.center` 默认取主题大圆角；`TPopupPlacement.left`、`TPopupPlacement.right` 默认**无圆角**（对齐官方全高矩形），仅当显式设置本字段或通过 `TPopupThemeData.panelRadius` 注入时应用圆角。 |
-| useSafeArea | bool | false | 是否避让系统安全区，默认 false；center 使用完整安全区，其他方向避让贴边侧及相邻边。 为 true 时通过 `Positioned` 偏移使面板不侵入刘海、Home Indicator 等区域； top/bottom/left/right 还会与对应 `inset` 叠加。需要避让时显式设为 true； 也可以在 `child` 内使用 Flutter 原生 `SafeArea`，只约束内容而保留面板背景贴边。 |
-
-
-##### TPopupOptions.bottom
-
-创建 `TPopupPlacement.bottom` 配置。
-固定 `placement` 为 `TPopupPlacement.bottom`；默认不显示头部。
-蒙层、动画、生命周期等字段语义见同名成员文档。
-
-其余参数见「通用参数」。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| height | double? | - | 高度；`TPopupPlacement.top`、`TPopupPlacement.bottom` 生效；`TPopupPlacement.center` 约束面板尺寸。 top / bottom 未传时默认 240；center 未传时默认 240。 |
-| inset | TPopupBottomInset? | - | 交叉轴边缘留白；具体类型由 `placement` 决定。 * `TPopupPlacement.bottom` 使用 `TPopupBottomInset` * `TPopupPlacement.top` 使用 `TPopupTopInset` * `TPopupPlacement.left` 使用 `TPopupLeftInset` * `TPopupPlacement.right` 使用 `TPopupRightInset` * `TPopupPlacement.center` 不支持 |
-| headerBuilder | TPopupHeaderBuilder? | - | bottom 头部；仅 `TPopupPlacement.bottom` 生效，默认不显示。 可返回 `TPopupHeader` 组合取消按钮、标题和确认按钮；builder 的 `close` 参数只负责关闭 Popup，不会自动生成任何按钮。 |
-
-
-##### TPopupOptions.center
-
-创建 `TPopupPlacement.center` 配置。
-固定 `placement` 为 `TPopupPlacement.center`；默认不显示关闭按钮。
-
-其余参数见「通用参数」。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | - | 宽度；`TPopupPlacement.left`、`TPopupPlacement.right`、`TPopupPlacement.center` 生效。 left / right 未传时默认 280；center 未传时默认 240。 |
-| height | double? | - | 高度；`TPopupPlacement.top`、`TPopupPlacement.bottom` 生效；`TPopupPlacement.center` 约束面板尺寸。 top / bottom 未传时默认 240；center 未传时默认 240。 |
-| closeBuilder | TPopupSlotBuilder? | - | center 面板外下方关闭区；仅 `TPopupPlacement.center` 生效，默认不显示。 builder 的 `close` 参数只负责关闭 Popup，不会自动生成关闭按钮。 |
-
-
-##### TPopupOptions.left
-
-创建 `TPopupPlacement.left` 配置。
-固定 `placement` 为 `TPopupPlacement.left`；未传 `width` 时布局默认宽度 280。
-
-其余参数见「通用参数」。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | - | 宽度；`TPopupPlacement.left`、`TPopupPlacement.right`、`TPopupPlacement.center` 生效。 left / right 未传时默认 280；center 未传时默认 240。 |
-| inset | TPopupLeftInset? | - | 交叉轴边缘留白；具体类型由 `placement` 决定。 * `TPopupPlacement.bottom` 使用 `TPopupBottomInset` * `TPopupPlacement.top` 使用 `TPopupTopInset` * `TPopupPlacement.left` 使用 `TPopupLeftInset` * `TPopupPlacement.right` 使用 `TPopupRightInset` * `TPopupPlacement.center` 不支持 |
-
-
-##### TPopupOptions.right
-
-创建 `TPopupPlacement.right` 配置。
-固定 `placement` 为 `TPopupPlacement.right`；未传 `width` 时布局默认宽度 280。
-
-其余参数见「通用参数」。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | - | 宽度；`TPopupPlacement.left`、`TPopupPlacement.right`、`TPopupPlacement.center` 生效。 left / right 未传时默认 280；center 未传时默认 240。 |
-| inset | TPopupRightInset? | - | 交叉轴边缘留白；具体类型由 `placement` 决定。 * `TPopupPlacement.bottom` 使用 `TPopupBottomInset` * `TPopupPlacement.top` 使用 `TPopupTopInset` * `TPopupPlacement.left` 使用 `TPopupLeftInset` * `TPopupPlacement.right` 使用 `TPopupRightInset` * `TPopupPlacement.center` 不支持 |
-
-
-##### TPopupOptions.top
-
-创建 `TPopupPlacement.top` 配置。
-固定 `placement` 为 `TPopupPlacement.top`；无内置头部。
-
-其余参数见「通用参数」。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
...（共 284 行）

tdesign-component/example/assets/api/radio_api.md

diff --git a/tdesign-component/example/assets/api/radio_api.md b/tdesign-component/example/assets/api/radio_api.md
index 250de02..0956a67 100644
--- a/tdesign-component/example/assets/api/radio_api.md
+++ b/tdesign-component/example/assets/api/radio_api.md
@@ -1,7 +1,5 @@
 ## API
 ### TRadio
-#### 简介
-遵循 Material value/groupValue 语义的严格受控单选框。
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -22,32 +20,7 @@
 | value | T | - | 当前选项值。 |
 
 
-### TRadioGroup
-#### 简介
-数据驱动且严格受控的单选框组。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| cardMode | bool | false | 是否使用卡片模式。 |
-| columns | int | 1 | 每行列数，必须大于 0。 |
-| contentDirection | TContentDirection | TContentDirection.right | 控件与文案排列方向。 |
-| direction | Axis | Axis.vertical | 排列方向。 |
-| iconType | TRadioIconType | TRadioIconType.fill | 内置指示器样式。 |
-| itemBuilder | TRadioOptionBuilder<T>? | - | 自定义数据项视觉；交互仍由组接管。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| onChanged | ValueChanged<T>? | - | 选中值变更回调；为 null 时整组禁用。 |
-| options | List<TRadioOption<T>> | - | 单选框数据项。 |
-| showDivider | bool | true | 是否显示项间分割线，默认显示；卡片模式不显示。 |
-| size | TRadioSize | TRadioSize.medium | 单选框尺寸。 |
-| subTitleMaxLines | int | 5 | 副标题最大行数，默认 5 行。 |
-| titleMaxLines | int | 3 | 主标题最大行数，默认 3 行。 |
-| value | T? | - | 受控选中值。 |
-
-
 ### TRadioSize
-#### 简介
-单选框指示器尺寸。
 #### 枚举值
 
 
@@ -59,8 +32,6 @@
 
 
 ### TRadioIconType
-#### 简介
-单选框内置指示器样式。
 #### 枚举值
 
 
@@ -72,8 +43,6 @@
 
 
 ### TRadioIconBuilder
-#### 简介
-自定义单选框指示器构建器。
 #### 类型定义
 
 ```dart
@@ -82,8 +51,6 @@ typedef TRadioIconBuilder = Widget Function(BuildContext context, bool selected,
 
 
 ### TRadioOptionBuilder
-#### 简介
-自定义单选框组数据项构建器。
 #### 类型定义
 
 ```dart

tdesign-component/example/assets/api/sidebar_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/sidebar_api.md	2026-09-02 06:57:41.665556495 +0000
@@ -0,0 +1 @@
+## API

tdesign-component/example/assets/api/skeleton_api.md

diff --git a/tdesign-component/example/assets/api/skeleton_api.md b/tdesign-component/example/assets/api/skeleton_api.md
index 9394bfa..39ed6d6 100644
--- a/tdesign-component/example/assets/api/skeleton_api.md
+++ b/tdesign-component/example/assets/api/skeleton_api.md
@@ -30,96 +30,6 @@
 | layout | TSkeletonLayout? | - | 自定义布局；预设形态时为空。 |
 
 
-### TSkeletonLayout
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| rows | List<List<TSkeletonBlock>> | - | 每个内层列表表示一行骨架块。 |
-| rowSpacing | double? | - | 行间距；未设置时读取组件主题和 TDesign token。 |
-
-
-### TSkeletonBlockStyle
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| borderRadius | double? | - | 骨架块圆角；优先于 `shape` 和组件主题。 |
-| color | Color? | - | 骨架块颜色；优先于组件主题。 |
-| shape | TSkeletonBlockShape | TSkeletonBlockShape.rounded | 骨架块形状。 |
-
-
-### TSkeletonBlock
-
-#### 工厂构造方法
-
-##### TSkeletonBlock.circle
-
-圆形占位块。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | 48 | 宽度。 |
-| height | double? | 48 | 高度。 |
-| flex | int? | - | 同一行内的弹性因子；为 null 时按固定宽度布局。 |
-| margin | EdgeInsets | EdgeInsets.zero | 外边距。 |
-| style | TSkeletonBlockStyle | const TSkeletonBlockStyle(shape: TSkeletonBlockShape.circle) | 视觉样式。 |
-
-
-##### TSkeletonBlock.line
-
-文本行占位块。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | - | 宽度。 |
-| height | double? | 16 | 高度。 |
-| flex | int? | 1 | 同一行内的弹性因子；为 null 时按固定宽度布局。 |
-| margin | EdgeInsets | EdgeInsets.zero | 外边距。 |
-| style | TSkeletonBlockStyle | const TSkeletonBlockStyle() | 视觉样式。 |
-
-
-##### TSkeletonBlock.rectangle
-
-无圆角矩形占位块。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | - | 宽度。 |
-| height | double? | 16 | 高度。 |
-| flex | int? | 1 | 同一行内的弹性因子；为 null 时按固定宽度布局。 |
-| margin | EdgeInsets | EdgeInsets.zero | 外边距。 |
-| style | TSkeletonBlockStyle | const TSkeletonBlockStyle(shape: TSkeletonBlockShape.rectangle) | 视觉样式。 |
-
-
-##### TSkeletonBlock.spacer
-
-透明间隔块。
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| width | double? | - | 宽度。 |
-| height | double? | - | 高度。 |
-| flex | int? | - | 同一行内的弹性因子；为 null 时按固定宽度布局。 |
-| margin | EdgeInsets | EdgeInsets.zero | 外边距。 |
-
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| flex | int? | 1 | 同一行内的弹性因子；为 null 时按固定宽度布局。 |
-| height | double? | 16 | 高度。 |
-| margin | EdgeInsets | EdgeInsets.zero | 外边距。 |
-| style | TSkeletonBlockStyle | const TSkeletonBlockStyle() | 视觉样式。 |
-| width | double? | - | 宽度。 |
-
-#### 公开属性
-
-| 属性 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| isSpacer | bool | - | 是否是透明间隔块。 |
-
-
 ### TSkeletonAnimation
 #### 枚举值
 
@@ -140,14 +50,3 @@
 | image | 图片占位。 |
 | text | 双行文本占位。 |
 | paragraph | 四行段落占位。 |
-
-
-### TSkeletonBlockShape
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| rounded | 使用组件主题或 TDesign token 提供的圆角。 |
-| circle | 圆形或胶囊形。 |
-| rectangle | 无圆角矩形。 |

tdesign-component/example/assets/api/slider_api.md

diff --git a/tdesign-component/example/assets/api/slider_api.md b/tdesign-component/example/assets/api/slider_api.md
index a6d4827..046e6cc 100644
--- a/tdesign-component/example/assets/api/slider_api.md
+++ b/tdesign-component/example/assets/api/slider_api.md
@@ -18,25 +18,6 @@
 | value | double | - | 受控滑块值。 |
 
 
-### TRangeSlider
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| divisions | int? | - | 离散刻度数；null 表示连续。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| max | double | 1 | 最大值。 |
-| min | double | 0 | 最小值。 |
-| onChanged | ValueChanged<RangeValues>? | - | 范围变更回调；为 null 时禁用。 |
-| onChangeEnd | ValueChanged<RangeValues>? | - | 结束拖动时触发。 |
-| onChangeStart | ValueChanged<RangeValues>? | - | 开始拖动时触发。 |
-| scaleFormatter | TSliderThumbFormatter? | - | 刻度值格式化回调。 |
-| showScaleValue | bool | false | 是否显示刻度值。 |
-| showThumbValue | bool | false | 是否显示拇指上方数值。 |
-| thumbFormatter | TSliderThumbFormatter? | - | 拇指上方数值格式化回调。 |
-| value | RangeValues | - | 受控范围值。 |
-
-
 ### TSliderThumbFormatter
 #### 类型定义

tdesign-component/example/assets/api/stepper_api.md

diff --git a/tdesign-component/example/assets/api/stepper_api.md b/tdesign-component/example/assets/api/stepper_api.md
index 4c772ee..890a518 100644
--- a/tdesign-component/example/assets/api/stepper_api.md
+++ b/tdesign-component/example/assets/api/stepper_api.md
@@ -12,46 +12,3 @@
 | step | num | 1 | 加减按钮使用的步长，必须大于 0。 输入提交不要求是步长的整数倍，但会限制在 `min` 与 `max` 之间。 |
 | value | num | - | 唯一受控数值，必须位于 `min` 与 `max` 之间。 父组件需要在 `onChanged` 后以新值重建组件，否则输入内容会恢复。 |
 | variant | TStepperVariant? | - | 组件形态。 为空时依次使用 `TStepperThemeData.variant` 和 `TStepperVariant.normal`。 |
-
-
-### TStepperThemeData
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| backgroundColor | Color? | - | filled 形态各段的背景色。 |
-| borderColor | Color? | - | outline 形态的描边颜色。 |
-| borderRadius | BorderRadius? | - | 分段圆角，默认使用 TDesign `radiusSmall`。 normal 和 filled 应用于每一段；outline 仅保留整组外侧圆角。 |
-| borderWidth | double? | - | outline 形态的描边宽度，默认 1。 |
-| controlSize | double? | - | 控件高度及单个按钮宽度。 为空时 small、medium、large 分别使用 20、24、26。 |
-| disabledBackgroundColor | Color? | - | 整组禁用时 filled 和 outline 形态各段的背景色。 |
-| disabledForegroundColor | Color? | - | 边界不可操作按钮及整组禁用时的前景色。 |
-| foregroundColor | Color? | - | 输入文字和加减图标的默认前景色。 |
-| iconSize | double? | - | 加减图标尺寸。 为空时 small、medium、large 分别使用 12、16、20。 |
-| inputWidth | double? | - | 输入段宽度。 为空时 small、medium、large 分别使用 34、38、45。 |
-| size | TStepperSize? | - | 默认尺寸；为空时使用 `TStepperSize.medium`。 |
-| spacing | double? | - | normal 和 filled 形态的分段间距，默认 4。 outline 始终连续排列，不使用该值。 |
-| textStyle | TextStyle? | - | 输入文字样式。 在继承 DefaultTextStyle 和 ThemeData.textTheme 后合并；非空字段可覆盖 默认字号、行高及 `foregroundColor`。 |
-| variant | TStepperVariant? | - | 默认形态；为空时使用 `TStepperVariant.normal`。 |
-
-
-### TStepperSize
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| small | 小尺寸：控件高度 20，输入段宽度 34，图标尺寸 12。 |
-| medium | 中尺寸：控件高度 24，输入段宽度 38，图标尺寸 16。 这是默认尺寸。 |
-| large | 大尺寸：控件高度 26，输入段宽度 45，图标尺寸 20。 |
-
-
-### TStepperVariant
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| normal | 透明分段形态，段间默认保留 4px 间距。 这是默认形态。 |
-| filled | 填充分段形态，三段使用背景色并保留默认 4px 间距。 |
-| outline | 连续描边形态，三段之间不保留间距。 |

tdesign-component/example/assets/api/steps_api.md

diff --git a/tdesign-component/example/assets/api/steps_api.md b/tdesign-component/example/assets/api/steps_api.md
index 0fb385c..f6e4614 100644
--- a/tdesign-component/example/assets/api/steps_api.md
+++ b/tdesign-component/example/assets/api/steps_api.md
@@ -15,19 +15,6 @@
 | verticalSelect | bool? | - | 步骤条垂直自定义步骤条选择模式（优先级高于 ThemeData） |
 
 
-### TStepsItemData
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| content | String? | - | 内容 |
-| customContent | Widget? | - | 自定义内容 |
-| customTitle | Widget? | - | 自定义标题 |
-| errorIcon | IconData? | - | 失败图标 |
-| successIcon | IconData? | - | 成功图标 |
-| title | String? | - | 标题 |
-
-
 ### TStepsDirection
 #### 枚举值

tdesign-component/example/assets/api/swipe_cell_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/swipe_cell_api.md	2026-09-02 06:57:41.011868396 +0000
@@ -0,0 +1,33 @@
+## API
+### TSwipeCell
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| child | Widget | - | 要增强为可滑动单元格的内容。 |
+| closeOnScroll | bool | true | 祖先滚动容器开始滚动时是否关闭面板，默认为 true。 |
+| controller | TSwipeCellController? | - | 命令式控制器。 |
+| enabled | bool | true | 是否允许用户拖动，默认为 true。 |
+| end | TSwipeCellPanel? | - | 结束侧操作面板。 |
+| initialOpenSide | TSwipeCellSide? | - | 首次布局后默认展开的面板；为空时保持关闭。 |
+| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
+| onOpenChanged | TSwipeCellChanged? | - | 面板展开状态变化回调。 |
+| start | TSwipeCellPanel? | - | 起始侧操作面板。 |
+
+
+### TSwipeCellSide
+#### 枚举值
+
+
+| 名称 | 说明 |
+| --- | --- |
+| start | - |
+| end | - |
+
+
+### TSwipeCellChanged
+#### 类型定义
+
+```dart
+typedef TSwipeCellChanged = void Function(TSwipeCellSide side, bool isOpen);
+```

tdesign-component/example/assets/api/swiper_api.md

diff --git a/tdesign-component/example/assets/api/swiper_api.md b/tdesign-component/example/assets/api/swiper_api.md
index 6cd23b9..e66ea3d 100644
--- a/tdesign-component/example/assets/api/swiper_api.md
+++ b/tdesign-component/example/assets/api/swiper_api.md
@@ -1,7 +1,5 @@
 ## API
 ### TSwiper
-#### 简介
-Controller 驱动的轮播组件。
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -31,103 +29,3 @@ Controller 驱动的轮播组件。
 | reverse | bool | false | 是否反转页面的视觉顺序和滚动方向。 |
 | scrollDirection | Axis | Axis.horizontal | 页面滚动方向。 |
 | viewportFraction | double | 1 | 每个页面占视口主轴的比例，必须大于零。 |
-
-
-### TSwiperController
-#### 简介
-控制 `TSwiper` 当前页和程序化切换。
-使用 `jumpTo`、`animateTo`、`next` 和 `previous` 发起切换，通过 `index`
-或监听 Controller 获取当前业务索引。一个 Controller 同时只能附加一个
-`TSwiper`，由调用方创建的实例也由调用方负责释放。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| initialIndex | int | 0 | 首次附加时展示的页面。 |
-
-
-### TSwiperThemeData
-#### 简介
-轮播组件级 ThemeExtension。
-保存页面效果、指示器和切换按钮的视觉默认值。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| activeColor | Color? | - | 激活项颜色。 |
-| activeDotExtent | double? | - | 长条激活项在滚动主轴上的长度。 |
-| controlIconSize | double? | - | 控制按钮图标尺寸。 |
-| controlStyle | ButtonStyle? | - | 控制按钮样式。 |
-| dotSize | double? | - | 圆点直径。 |
-| dotSpacing | double? | - | 圆点间距。 |
-| fractionBackgroundColor | Color? | - | 数字指示器背景色。 |
-| fractionStyle | TextStyle? | - | 数字指示器文字样式。 |
-| inactiveColor | Color? | - | 未激活项颜色。 |
-| pageEffect | TSwiperPageEffect? | - | 默认页面切换效果。 |
-| pagination | TSwiperPaginationVariant? | - | 默认指示器形态。 |
-| paginationAlignment | AlignmentGeometry? | - | 默认指示器对齐方式。 |
-| paginationMargin | EdgeInsetsGeometry? | - | 指示器外边距。 |
-| paginationPlacement | TSwiperPaginationPlacement? | - | 默认指示器位置。 |
-
-
-### TSwiperPaginationItemDetails
-#### 简介
-单个轮播指示器标记的状态信息。
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| axis | Axis | - | 轮播滚动主轴。 |
-| currentIndex | int | - | 当前实际展示页的业务下标。 |
-| index | int | - | 当前标记对应的业务下标。 |
-| itemCount | int | - | 轮播项总数。 |
-
-
-### TSwiperPaginationVariant
-#### 简介
-轮播指示器形态。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| none | 不显示指示器。 |
-| dots | 圆点指示器。 |
-| dotsBar | 当前项使用长条的圆点指示器。 |
-| fraction | 数字指示器。 |
-| controls | 前后切换按钮。 |
-
-
-### TSwiperPaginationPlacement
-#### 简介
-指示器相对于轮播内容的位置。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| overlay | 覆盖在轮播内容上。 |
-| outside | 放在轮播内容外部；横向轮播放在下方，竖向轮播放在右侧。 |
-
-
-### TSwiperPageEffect
-#### 简介
-页面切换视觉效果。
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| none | 无额外效果。 |
-| cardMargin | 卡片间距效果。 |
-| scaleAndFade | 缩放和透明度效果。 |
-
-
-### TSwiperPaginationItemBuilder
-#### 简介
-单个轮播指示器标记的构建器。
-#### 类型定义
-
-```dart
-typedef TSwiperPaginationItemBuilder = Widget Function(BuildContext context, TSwiperPaginationItemDetails details);
-```

tdesign-component/example/assets/api/tag_api.md

diff --git a/tdesign-component/example/assets/api/tag_api.md b/tdesign-component/example/assets/api/tag_api.md
index 823b051..6f6c625 100644
--- a/tdesign-component/example/assets/api/tag_api.md
+++ b/tdesign-component/example/assets/api/tag_api.md
@@ -14,18 +14,3 @@
 | onTap | GestureTapCallback? | - | 标签点击回调；为空时不创建标签点击行为。 |
 | size | TTagSize | TTagSize.medium | 标签大小 |
 | variant | TTagVariant | TTagVariant.dark | 绘制形态。 |
-
-
-### TSelectTag
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| text | String | - | 标签内容。 |
-| colorScheme | TTagColorScheme | TTagColorScheme.primary | 选中态预设配色。 |
-| icon | IconData? | - | 标签图标。 |
-| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
-| onChanged | ValueChanged<bool>? | - | 选中状态变更回调；为空时禁用交互。 |
-| size | TTagSize | TTagSize.medium | 标签尺寸。 |
-| value | bool | - | 当前选中状态。 |
-| variant | TTagVariant | TTagVariant.dark | 标签绘制形态。 |

tdesign-component/example/assets/api/text_api.md

diff --git a/tdesign-component/example/assets/api/text_api.md b/tdesign-component/example/assets/api/text_api.md
index bacf0ab..5d95d97 100644
--- a/tdesign-component/example/assets/api/text_api.md
+++ b/tdesign-component/example/assets/api/text_api.md
@@ -64,57 +64,3 @@
 | 属性 | 类型 | 默认值 | 说明 |
 | --- | --- | --- | --- |
 | textSpan | InlineSpan? | - | 富文本内容。 |
-
-
-### TTextSpan
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| children | List<InlineSpan>? | - | 透传至 `TextSpan.children`。 |
-| font | Font? | - | TDesign 字体 Token，包含字号、行高和字重。 |
-| fontFamily | FontFamily? | - | 字体族及可选资源 package。 |
-| fontWeight | FontWeight? | - | 字体粗细。 |
-| isTextThrough | bool? | - | 是否显示删除线。为 null 时继承父 Span。 |
-| lineThroughColor | Color? | - | 删除线颜色。 |
-| locale | Locale? | - | 透传至 `TextSpan.locale`。 |
-| mouseCursor | MouseCursor? | - | 透传至 `TextSpan.mouseCursor`。 |
-| onEnter | PointerEnterEventListener? | - | 透传至 `TextSpan.onEnter`。 |
-| onExit | PointerExitEventListener? | - | 透传至 `TextSpan.onExit`。 |
-| recognizer | GestureRecognizer? | - | 透传至 `TextSpan.recognizer`。 |
-| semanticsIdentifier | String? | - | 透传至 `TextSpan.semanticsIdentifier`。 |
-| semanticsLabel | String? | - | 透传至 `TextSpan.semanticsLabel`。 |
-| spellOut | bool? | - | 透传至 `TextSpan.spellOut`。 |
-| style | TextStyle? | - | Flutter 原生文字样式，具有最高优先级。 |
-| text | String? | - | 透传至 `TextSpan.text`。 |
-| textColor | Color? | - | 文字颜色。 |
-
-
-### TTextThemeData
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| font | Font? | - | 默认 TDesign 字体 Token。 |
-| strutStyle | StrutStyle? | - | 默认段落支柱样式。 |
-| textHeightBehavior | ui.TextHeightBehavior? | - | 默认文本高度行为。 |
-| textStyle | TextStyle? | - | 默认 Flutter 文字样式。 |
-| textWidthBasis | TextWidthBasis? | - | 默认文本宽度计算方式。 |
-
-
-### TFontLoader
-
-#### 静态方法
-
-##### TFontLoader.load
-
-下载并注册字体。
-同一 `name` 和 `fontFamilyUrl` 的并发调用共享同一个 Future。加载失败会
-清除缓存并允许重试；已经注册或正在注册的字体不能切换 URL。
-
-返回类型：`Future<bool>`
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| name | String | - | - |
-| fontFamilyUrl | String | - | - |

tdesign-component/example/assets/api/textarea_api.md

diff --git a/tdesign-component/example/assets/api/textarea_api.md b/tdesign-component/example/assets/api/textarea_api.md
index 2b1ba7b..64fbb60 100644
--- a/tdesign-component/example/assets/api/textarea_api.md
+++ b/tdesign-component/example/assets/api/textarea_api.md
@@ -1,10 +1,5 @@
 ## API
 ### TTextarea
-#### 简介
-TDesign 多行文本输入框。
-编辑能力复用 `TInput`；容器、内部标题、提示词和计数器遵循
-Textarea 的视觉契约。表单字段标签仍应由 `TFormItem` 提供，`label` 仅用于
-独立 Textarea 自身的内部标题。
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |

tdesign-component/example/assets/api/time_counter_api.md

--- /dev/null	2026-09-02 06:55:13.308685682 +0000
+++ ./tdesign-component/example/assets/api/time_counter_api.md	2026-09-02 06:57:41.787870246 +0000
@@ -0,0 +1,27 @@
+## API
+### TTimeCounter
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| autoStart | bool | true | 是否自动开始倒计时 |
+| content | TTimeCounterBuilder? | - | 自定义计时内容；为空时使用标准数字块。 |
+| controller | TTimeCounterController? | - | 控制器，可控制开始/暂停/继续/重置 |
+| direction | TTimeCounterDirection | TTimeCounterDirection.down | 计时方向，默认倒计时 |
+| format | String | 'HH:mm:ss' | 时间格式，DD-日，HH-时，mm-分，ss-秒，SSS-毫秒（分隔符必须为长度为1的非空格的字符） |
+| key | Key? | - | 组件标识，用于区分或保留组件状态。 |
+| onChanged | ValueChanged<int>? | - | 时间变化时触发回调 |
+| onFinish | VoidCallback? | - | 计时结束时触发回调 |
+| showMillisecond | bool? | - | 是否显示毫秒；优先于组件 Theme。 |
+| size | TTimeCounterSize? | - | 计时器尺寸；优先于组件 Theme。 |
+| splitWithUnit | bool? | - | 是否使用本地化时间单位分隔；优先于组件 Theme。 |
+| time | int | - | 必需；计时时长，单位毫秒 |
+| variant | TTimeCounterVariant? | - | 视觉形态；优先于组件 Theme。 |
+
+
+### TTimeCounterBuilder
+#### 类型定义
+
+```dart
+typedef TTimeCounterBuilder = Widget Function(int time);
+```

tdesign-component/example/assets/api/upload_api.md

diff --git a/tdesign-component/example/assets/api/upload_api.md b/tdesign-component/example/assets/api/upload_api.md
index db47792..bf49b83 100644
--- a/tdesign-component/example/assets/api/upload_api.md
+++ b/tdesign-component/example/assets/api/upload_api.md
@@ -16,105 +16,3 @@
 | onFileTap | ValueChanged<TUploadFile>? | - | 点击任意状态的已有文件时触发；组件不会自动预览或重新上传。 |
 | onValidationError | ValueChanged<TUploadValidationError>? | - | 文件校验失败时触发。 |
 | picker | TUploadPicker? | - | 自定义文件选择器；为空时使用 image_picker。 |
-
-
-### TUploadFile
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| bytes | Uint8List? | - | 本地预览字节。 |
-| canRemove | bool | true | 是否允许移除。 |
-| errorText | String? | - | 失败状态文案。 |
-| id | String | - | 文件唯一标识。 |
-| name | String | - | 文件名。 |
-| progress | double? | - | 上传进度，范围为 0 到 1。 |
-| size | int? | - | 文件字节数。 |
-| status | TUploadFileStatus | TUploadFileStatus.ready | 上传状态。 |
-| url | String? | - | 远程预览地址。 |
-
-
-### TUploadThemeData
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| addIconSize | double? | - | 添加图标尺寸。 |
-| alignment | WrapAlignment? | - | Wrap 对齐方式。 |
-| backgroundColor | Color? | - | 默认背景色。 |
-| borderRadius | double? | - | 方形上传项圆角。 |
-| disabledBackgroundColor | Color? | - | 禁用背景色。 |
-| disabledForegroundColor | Color? | - | 禁用前景色。 |
-| disabledMaskColor | Color? | - | 禁用文件遮罩颜色。 |
-| foregroundColor | Color? | - | 默认前景色。 |
-| itemSize | double? | - | 上传项尺寸。 |
-| overlayColor | Color? | - | 状态遮罩颜色。 |
-| removeButtonColor | Color? | - | 移除按钮颜色。 |
-| removeButtonSize | double? | - | 移除按钮尺寸。 |
-| removeIconSize | double? | - | 移除图标尺寸。 |
-| runSpacing | double? | - | 纵向间距。 |
-| spacing | double? | - | 横向间距。 |
-| statusIconSize | double? | - | 状态图标尺寸。 |
-| statusTextStyle | TextStyle? | - | 状态文案样式。 |
-| variant | TUploadVariant? | - | 上传项形状。 |
-
-
-### TUploadFileStatus
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| ready | 已选择，等待业务上传。 |
-| uploading | 上传中。 |
-| success | 上传成功。 |
-| error | 上传失败。 |
-| retryableError | 上传失败且允许重试。 该状态只控制刷新图标和“重新上传”文案；组件不会自动重试。 |
-
-
-### TUploadLayout
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| grid | 宫格布局。 |
-| list | 列表布局。 |
-
-
-### TUploadVariant
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| square | 圆角方形。 |
-| circle | 圆形。 |
-
-
-### TUploadMediaType
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| image | 图片。 |
-| video | 视频。 |
-
-
-### TUploadValidationError
-#### 枚举值
-
-
-| 名称 | 说明 |
-| --- | --- |
-| maxFiles | 超出最大文件数量。 |
-| fileSize | 文件大小超出限制。 |
-
-
-### TUploadPicker
-#### 类型定义
-
-```dart
-typedef TUploadPicker = Future<List<TUploadFile>> Function();
-```

github-actions · 2026-09-02T06:59:44Z

预览地址: https://preview-pr-26-tdesign-flutter-tools.surge.sh

fix: detect Dart SDK behind Flutter wrappers

c65d27b

Navigation Menu

fix: detect Dart SDK behind Flutter wrappers - #26

fix: detect Dart SDK behind Flutter wrappers#26
RSS1102 wants to merge 1 commit into
mainfrom
rss1102/fix/dart-sdk-detection

RSS1102 commented Sep 2, 2026

Uh oh!

github-actions Bot commented Sep 2, 2026

Uh oh!

github-actions Bot commented Sep 2, 2026

Uh oh!

github-actions Bot commented Sep 2, 2026

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

RSS1102 commented Sep 2, 2026

问题

根因

修改

验证

Uh oh!

github-actions Bot commented Sep 2, 2026

Uh oh!

github-actions Bot commented Sep 2, 2026

文档变更

Uh oh!

github-actions Bot commented Sep 2, 2026

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant