x-next 1.16.1 → 1.18.0

package/AI_USAGE.md

@@ -1,11 +1,11 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 使用手册
 
-适用版本：**x-next@1.16.1**。Vue：`^3.5.0`；Node：`>=20.19.0`。
+适用版本：**x-next@1.18.0**。Vue：`^3.5.0`；Node：`>=20.19.0`。
 
-来源指纹（AI 行为说明、docs 导入快照、映射、样式依赖、版本、公开类型和 API 参考）：`82741ea6b533ff677d8fd71ad9c907c9d8ffe3f134b363bb1584668c30115b17`。
+来源指纹（AI 行为说明、docs 导入快照、映射、样式依赖、版本、公开类型和 API 参考）：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
 
-覆盖 58 个组件族与 105 个公开组件/服务导出。优先通过 [本地按需索引](./AI_USAGE/index.md) 读取组件页和 API，不为查本包用法默认搜索网络。
+覆盖 59 个组件族与 106 个公开组件/服务导出。优先通过 [本地按需索引](./AI_USAGE/index.md) 读取组件页和 API，不为查本包用法默认搜索网络。
 
 读取入口：`node_modules/x-next/AI_USAGE.md`；可用 `require.resolve('x-next/AI_USAGE.md')` 定位。消费项目应在自己的指令中明确引用。
 
@@ -41,6 +41,7 @@
 | Steps | `Steps` | `<x-steps>` | `v-model:current` | `x-next/style/steps` | 无独立依赖 | [组件文档](https://x-next.yjmf.com/components/steps) |
 | Tabs | `Tabs` | `<x-tabs>` | `v-model:active-key` | `x-next/style/tabs` | 无独立依赖 | [组件文档](https://x-next.yjmf.com/components/tabs) |
 | TreeSelect | `TreeSelect`, `TreeSelectDropdown` | `<x-tree-select>` | `v-model`, `v-model:input-value`, `v-model:popup-visible`, `v-model:expanded-keys` | `x-next/style/tree-select` | `empty.css`, `form-checkbox.css`, `form-select.css`, `scrollbar-v2.css`, `spin.css`, `trigger.css` | [组件文档](https://x-next.yjmf.com/components/tree-select) |
+| Transfer | `Transfer` | `<x-transfer>` | `v-model`, `v-model:selected-keys` | `x-next/style/transfer` | `button.css`, `empty.css`, `form-checkbox.css`, `form-input.css`, `form-input-number.css`, `form-select.css`, `pagination.css`, `scrollbar-v2.css`, `spin.css`, `trigger.css` | [组件文档](https://x-next.yjmf.com/components/transfer) |
 | Empty | `Empty` | `<x-empty>` | 无 | `x-next/style/empty` | 无独立依赖 | [组件文档](https://x-next.yjmf.com/components/empty) |
 | Upload | `Upload` | `<x-upload>` | `v-model:file-list` | `x-next/style/upload` | `image.css`, `progress.css`, `trigger.css`, `tooltip.css` | [组件文档](https://x-next.yjmf.com/components/upload) |
 | BarChart | `BarChart` | `<x-bar-chart>` | 无 | `x-next/style/bar-chart` | `spin.css` | [组件文档](https://x-next.yjmf.com/components/bar-chart) |
@@ -225,7 +226,7 @@ const pickerAttrs = { id: 'brand-color', 'aria-label': '品牌色' };
 
 ## Button
 
-[组件文档与 live demo](https://x-next.yjmf.com/components/button)。`type` 默认 `'default'`，视觉主按钮用 `'primary'`；`htmlType` 默认 `'button'`，原生提交用 `'submit'`。尺寸优先级为显式 `size` → ButtonGroup → ConfigProvider → `'medium'`；Button 不通过 FormItem 继承尺寸。`disabled` / `loading` 默认关闭。
+[组件文档与 live demo](https://x-next.yjmf.com/components/button)。`type` 管形态，默认 `'default'`；实心用 `'solid'`、弱底用 `'subtle'`、透明用 `'outline'/'dashed'/'text'`。`status` 管颜色，默认中性 `'default'`，品牌色显式 `'primary'`。默认与中性 outline 是同一普通操作层级的弱底 / 透明表面差异；品牌描边显式使用 status=primary。兼容 `type='primary'` 解析品牌实心，其他语义 status 优先；`plain` 仅把填充形态转为 subtle，`border=false` 只隐藏边框；语义弱底不额外描边，中性默认保留细边，outline/dashed 需要边框。波纹颜色跟随状态；text、disabled/loading 无外部波纹。深灰实心是独立纯灰的高权重进阶组合，不代表次要或禁用。text 保留按钮点击区域，`type="text" narrow` 去掉水平内边距且保持按钮高度；URL 导航用 Link 的 href 或项目路由方案。Button 不提供 link 类型或布尔 link 属性。`htmlType` 默认 `'button'`，原生提交用 `'submit'`。尺寸优先级为显式 `size` → ButtonGroup → ConfigProvider → `'medium'`；Button 不通过 FormItem 继承尺寸。`disabled` / `loading` 默认关闭。
 
 `click` 载荷为 `MouseEvent`，禁用或加载中不会触发。`default`、`prefix`、`suffix`、`icon` 插槽可组合内容；异步业务自行维护 `loading`。
 
@@ -783,6 +784,40 @@ function resized(size: number) { current.value = 1; feedback.value = `每页 ${s
 </template>
 ```
 
+## Transfer
+
+[组件文档与 live demo](https://x-next.yjmf.com/components/transfer)。`data` 是 `{ value: string | number, label: string, disabled?: boolean }[]`，可附加业务字段。`v-model` 是目标侧值数组；`v-model:selected-keys` 是两侧临时勾选数组，彼此独立。`defaultValue` / `defaultSelectedKeys` 只初始化非受控状态。数字与字符串值不同；重复数据值保留首项。目标模型中的未加载值不展示，移动其他项时仍保留。
+
+`showSearch=false`、`showSelectAll=true`、`simple=false`、`oneWay=false`、`loading=false`、`disabled=false`。搜索默认不区分大小写，`filterOption(input, item, type)` 适配业务字段。全选只处理当前搜索结果，分页时仅当前页，禁用项不参与；已勾选的搜索隐藏项仍可移动。`simple` 点击即移动；`oneWay` 只显示向右按钮，目标侧逐项移除，禁用项不可移除。加载阻止操作。`targetOrder='original'` 按源数据排序，`append` 按模型顺序。
+
+`change(values, type, movedValues)` 的 `type` 是目的侧 `'source' | 'target'`；`select(sourceSelected, targetSelected)` 报告两侧有效勾选；`search(input, type)`、`scroll(event, type)` 报告源/目标侧。受控模型必须回写；不回写时不提交界面状态。Form 只在移动时触发 change，搜索/临时勾选不触发字段校验。
+
+`pagination=true | { pageSize }` 默认每页 10，优先于 `virtualListProps`。`item` 自定义内容；`source` / `target` 替换列表，提供 `data`、`pageData`、`selectedKeys`、`disabled`、`onSelect(value, checked)`、`onSelectAll(values, checked)`、`onMove(values)`。回调统一校验同侧、存在性、禁用和加载。自定义列表自行实现空态、虚拟滚动及键盘语义；默认列表用 Tab/Space 和方向键/Home/End 操作。没有 readonly、远程分页、拖拽排序或字段映射 API。
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Transfer } from 'x-next';
+import type { TransferItem, TransferValue, TransferType } from 'x-next';
+import 'x-next/style/transfer';
+const values = ref<TransferValue[]>(['audit']);
+const data: TransferItem[] = [
+  { value: 'read', label: '查看数据' },
+  { value: 'edit', label: '编辑数据' },
+  { value: 'audit', label: '审核数据' },
+  { value: 'admin', label: '管理配置', disabled: true },
+];
+const log = ref('');
+function changed(next: TransferValue[], type: TransferType, moved: TransferValue[]) {
+  log.value = `${type} ${moved.join(',')}；目标值 ${JSON.stringify(next)}`;
+}
+</script>
+<template>
+  <Transfer v-model="values" :data="data" show-search @change="changed" />
+  <p aria-live="polite">{{ log }}</p>
+</template>
+```
+
 ## TreeSelect
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/tree-select)。用于在层级数据中选择节点，`data` 是 `{ key, title, children }` 树。单选为标量、`multiple` 为数组、`treeCheckable` 勾选模式始终返回数组；`allowSearch` 默认多选 / 勾选开启、单选关闭，`checkedStrategy` 默认 `parent`。
@@ -1541,14 +1576,141 @@ import { Button } from 'x-next';
 <template>
 <Button>默认按钮</Button>
   <Button type="primary">主要按钮</Button>
-  <Button type="outline">描边按钮</Button>
+  <Button type="outline" status="primary">品牌描边</Button>
   <Button type="text">文本按钮</Button>
 </template>
 ```
 
+### 形态与颜色
+
+通过 `type` 设置形态，通过 `status` 设置颜色。品牌色使用 `status="primary"`。
+
+| 形态 | 表现 |
+| --- | --- |
+| default | 浅色背景；中性按钮有细边框，状态色按钮无边框 |
+| solid | 实心底、白字 |
+| subtle | 弱填充、无可见边框 |
+| outline / dashed | 透明底、实线 / 虚线边框 |
+| text | 透明文字，保留按钮尺寸与内边距 |
+
+### 文本动作与跳转链接
+
+`type="text"` 适合表格或工具栏操作，加上 `narrow` 可去掉水平内边距。跳转页面使用 `x-link` 的 `href`。
+
+### 进阶组合：深灰实心
+
+深灰实心适合黑白品牌或强调操作；次要操作可使用默认或文本按钮。
+
+### 组合预览
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Button } from 'x-next';
+
+</script>
+<template>
+<Button type="solid" status="primary">品牌实心</Button>
+  <Button type="subtle" status="primary">品牌弱底</Button>
+  <Button type="outline" status="primary">品牌描边</Button>
+  <Button type="text" status="primary">品牌文本</Button>
+</template>
+```
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { ref } from 'vue';
+import { Button as XButton, Link as XLink } from 'x-next';
+import 'x-next/style/button';
+import 'x-next/style/link';
+const textCount = ref(0);
+const compactCount = ref(0);
+</script>
+<template>
+<XButton type="text" status="primary" @click="textCount++">文本操作</XButton>
+  <span>行内动作：<XButton type="text" narrow status="primary" @click="compactCount++">紧凑文本操作</XButton></span>
+  <XLink href="/components/link" :hoverable="false">查看 Link 文档</XLink>
+  <span role="status">文本操作 {{ textCount }} 次，紧凑操作 {{ compactCount }} 次</span>
+</template>
+```
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Button } from 'x-next';
+
+</script>
+<template>
+<Button type="solid">深灰实心</Button>
+</template>
+```
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { ref } from 'vue';
+import { Button as XButton, ButtonGroup as XButtonGroup, Select as XSelect, Checkbox as XCheckbox } from 'x-next';
+import type { ButtonTypes, ButtonStatus } from 'x-next';
+import 'x-next/style/button';
+import 'x-next/style/form-select';
+import 'x-next/style/form-checkbox';
+const types = ['default', 'solid', 'subtle', 'outline', 'dashed', 'text', 'primary'] as const;
+const statuses = ['default', 'primary', 'success', 'warning', 'strong', 'danger', 'info'] as const;
+const typeOptions = types.map(value => ({ label: value, value }));
+const statusOptions = statuses.map(value => ({ label: value, value }));
+const typeAttrs = { 'aria-label': '按钮形态' };
+const statusAttrs = { 'aria-label': '按钮颜色' };
+const type = ref<ButtonTypes>('outline');
+const status = ref<ButtonStatus>('default');
+const plain = ref(false), border = ref(true), count = ref(0);
+</script>
+<template>
+<div class="button-controls">
+    <div class="button-field">
+      <span>形态</span>
+      <XSelect v-model="type" :options="typeOptions" v-bind="typeAttrs" class="button-select" />
+    </div>
+    <div class="button-field">
+      <span>颜色</span>
+      <XSelect v-model="status" :options="statusOptions" v-bind="statusAttrs" class="button-select" />
+    </div>
+    <XCheckbox v-model="plain">plain</XCheckbox>
+    <XCheckbox v-model="border">border</XCheckbox>
+  </div>
+  <XButton :type="type" :status="status" :plain="plain" :border="border" @click="count++">组合按钮</XButton>
+  <span role="status">已触发 {{ count }} 次</span>
+  <XButtonGroup type="outline">
+    <XButton :border="false">组内无边框一</XButton>
+    <XButton :border="false">组内无边框二</XButton>
+  </XButtonGroup>
+</template>
+<style scoped>
+.button-controls {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 12px;
+}
+.button-field {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex: none;
+}
+.button-field > span {
+  white-space: nowrap;
+}
+.button-field :deep(.button-select) {
+  width: 136px;
+  flex: none;
+}
+</style>
+```
+
 ### 外部水波纹
 
-Button 默认开启类似 Ant Design Vue 的外部轮廓水波纹。`disabled`、`loading`、`link` 和 `type="text"` 状态不会展示外部水波纹。
+点击按钮查看反馈。禁用、加载或文本按钮不显示水波纹。
 
 ```vue
 <script setup lang="ts">
@@ -1560,6 +1722,7 @@ import { Button } from 'x-next';
 <Button>默认水波纹</Button>
   <Button type="primary">主要水波纹</Button>
   <Button status="danger">危险水波纹</Button>
+  <Button type="outline" status="danger">危险描边水波纹</Button>
   <Button loading>加载不触发</Button>
   <Button disabled>禁用不触发</Button>
 </template>
@@ -1567,6 +1730,8 @@ import { Button } from 'x-next';
 
 ### 状态
 
+通过 `status` 表达成功、警告、危险等状态。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -1584,15 +1749,45 @@ import { Button } from 'x-next';
 </template>
 ```
 
-### 状态色实心按钮
+### 暗色状态按钮
 
-五种状态色都提供实心（高亮）形态，**统一使用白字**与主题惯例一致。实心底色即主题种子色：主要 `#1c61ff`、成功 `#00a809`、警告 `#ffb800`、强调 `#ff8200`、危险 `#e02225`。
+通过 `ConfigProvider` 的 `dark` 属性设置局部暗色。
 
-危险色种子 `#e02225` 的白字对比为 4.75:1，实心底直接使用种子本身，不再需要压暗变体。
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Button as XButton, ConfigProvider as XConfigProvider } from 'x-next';
+import 'x-next/style/base.css';
+import 'x-next/style/button.css';
+</script>
+<template>
+<XConfigProvider :dark="true" class="button-dark-example">
+    <XButton>默认</XButton>
+    <XButton status="success">成功</XButton>
+    <XButton status="warning">警告</XButton>
+    <XButton status="strong">强调</XButton>
+    <XButton status="danger">危险</XButton>
+    <XButton status="info">信息</XButton>
+    <XButton disabled>禁用</XButton>
+  </XConfigProvider>
+</template>
+<style scoped>
+.button-dark-example {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  padding: 20px;
+  border-radius: 8px;
+  background: var(--x-color-bg-surface);
+}
+</style>
+```
+
+### 状态色实心按钮
 
-实心底与白字在明暗主题下都恒定不翻转，因此暗色下仍是同一块强调色。更换主题种子色（`base.scss` 的 `--x-color-<name>`）后实心按钮整体联动。
+实心按钮适合强调操作，搭配 `status` 设置颜色。
 
-亮黄色、亮橙色实底上的白字属于主题惯例内的折中：这类底亮度过高，强行让白字达到正文级 4.5:1 只能压深到底色失去品牌识别。参考 Arco 的橙色实底白字为 2.57:1、Ant Design 的 `warning` 为 1.90:1，本库 `warning` / `strong` 与二者处于同一水平。需要更高可读性时，可改用 `type="outline"`、`plain` 或 `type="text"` 形态，或把种子色选得更深。各状态实测值与回归下限由 `script/check-contrast.js` 守护。
+黄色、橙色实心按钮的文字对比较弱，需要更高可读性时可选用描边或弱底形态。
 
 ```vue
 <script setup lang="ts">
@@ -1611,25 +1806,11 @@ import { Button } from 'x-next';
 
 ### 类型与边框
 
-`border="false"` 使用弱背景状态色，不会切换成实心危险按钮。需要实心危险按钮时使用 `type="primary" status="danger"`。
-
-`link` 保持透明背景和对应状态文字色，非圆形链接按钮的高度随文字行高变化、没有水平内边距。禁用和加载期间不会响应悬浮或按下颜色。
-
-彩色文字按钮（`plain`、`outline`、`text`、`link`）在亮色主题中沿用品牌主色，暗色主题中使用同色系的亮色档，与 Link、Tag 同源。对比度下限对齐 Arco 同级角色，由 `script/check-contrast.js` 的 `ARCO_BASELINE` 守护。
+`:border="false"` 只隐藏边框。需要弱底危险按钮时使用 `type="subtle" status="danger"`，实心危险按钮使用 `type="solid" status="danger"`。
 
-### 交互三态
+### 交互状态
 
-按钮的常态、悬浮、按下按**渐深梯度**设计，每一级都可感知且保持轻盈（明度差 ≥ 0.025，由门禁守护）：
-
-| 形态 | 常态 | 悬浮 | 按下 |
-| --- | --- | --- | --- |
-| 默认 / 信息（灰色系） | `fill-2` | `neutral-3` | `neutral-4` |
-| 彩色弱底 / 描边 / 文本（除 warning） | 无色或同色浅底 | 同色浅底混入按钮文字色 10% | 同色浅底混入按钮文字色 16% |
-| warning 弱底 / 描边 / 文本 | 无色或同色浅底 | 同色浅底混入按钮文字色 25% | 同色浅底混入按钮文字色 40% |
-| 链接 | 透明背景、状态文字色 | 保持常态 | 保持常态 |
-| 实色 | 种子实底 | 混白 8%（更亮） | 混恒定深 10%（更深） |
-
-默认按钮不用 `fill-2/3/4` 递进：全局 fill 灰阶在浅端被压缩，`fill-2` 与 `fill-3` 只差 3 个通道，悬浮态几乎看不出变化；改用 `neutral-3/4` 后与 Arco 的步进一致。
+悬浮或按住按钮查看状态变化，也可用 Tab 聚焦后按 Space / Enter 操作。第二组展示局部暗色。
 
 ```vue
 <script setup lang="ts">
@@ -1643,15 +1824,52 @@ import { Button } from 'x-next';
   <Button type="text">文本按钮</Button>
   <Button plain status="success">朴素成功</Button>
   <Button :border="false" status="danger">无边框危险</Button>
-  <Button link>链接按钮</Button>
-  <Button link status="danger">危险链接</Button>
-  <Button link disabled>禁用链接</Button>
+  <Button type="text" narrow>紧凑文本</Button>
+  <Button type="text" narrow status="danger">危险文本</Button>
+  <Button type="text" narrow disabled>禁用文本</Button>
 </template>
 ```
 
-### 状态矩阵
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { ref } from 'vue';
+import { Button as XButton, ConfigProvider as XConfigProvider } from 'x-next';
+import 'x-next/style/base.css';
+import 'x-next/style/button.css';
+
+const count = ref(0);
+const statuses = ['default', 'primary', 'success', 'warning', 'strong', 'danger', 'info'] as const;
+</script>
+<template>
+<div v-for="status in statuses" :key="status">
+    <XButton type="outline" :status="status" @click="count++">描边</XButton>
+    <XButton type="dashed" :status="status" @click="count++">虚线</XButton>
+    <XButton type="text" :status="status" @click="count++">文本</XButton>
+    <XButton type="text" narrow :status="status" @click="count++">紧凑文本</XButton>
+  </div>
+  <XConfigProvider :dark="true" class="button-dark-example">
+    <XButton type="outline" @click="count++">暗色描边</XButton>
+    <XButton type="dashed" @click="count++">暗色虚线</XButton>
+    <XButton type="text" @click="count++">暗色文本</XButton>
+    <XButton type="text" narrow @click="count++">暗色紧凑文本</XButton>
+    <XButton type="outline" disabled>禁用</XButton>
+    <XButton type="text" loading>加载</XButton>
+  </XConfigProvider>
+  <span role="status">已触发 {{ count }} 次</span>
+</template>
+<style scoped>
+.button-dark-example {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+  padding: 20px;
+  background: var(--x-color-bg-surface);
+}
+</style>
+```
 
-Button 的状态色基于组件 alias token 组织，例如 `--x-button-color-bg-danger-subtle`、`--x-button-color-bg-danger-solid`、`--x-button-color-text-danger`。后续自定义主题可以优先覆盖这些组件级 token。
+### 状态矩阵
 
 ```vue
 <script setup lang="ts">
@@ -1763,6 +1981,15 @@ const pushLog = (label: string) => {
 
 `type` 控制视觉样式，`html-type` 控制原生按钮行为。默认 `html-type="button"`，不会因为放进表单而意外提交。
 
+### 原生动作与防重复点击
+
+<form class="example-box example-box-column" data-demo="button-native-debounce" @submit.prevent="nativeCount++" @reset="formStatus = '防重复示例已重置'">
+  <label>必填内容 <input name="message" required value="初始内容" /></label>
+  <span role="status">已提交 {{ nativeCount }} 次；{{ formStatus }}</span>
+</form>
+
+`debounce` 用于防止重复点击，提交结果在表单的 submit 事件中处理。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -1780,6 +2007,23 @@ const handleSubmit = () => {
 </template>
 ```
 
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Button } from 'x-next';
+import { ref } from 'vue';
+const count = ref(0), message = ref('尚未重置');
+</script>
+<template>
+<form @submit.prevent="count++" @reset="message = '已重置'">
+    <label>必填内容 <input name="message" required value="初始内容" /></label>
+    <Button type="solid" status="primary" html-type="submit" :debounce="800">防重复提交</Button>
+    <Button html-type="reset" :debounce="800">防重复重置</Button>
+    <span role="status">已提交 {{ count }} 次；{{ message }}</span>
+  </form>
+</template>
+```
+
 ### 文字与图标
 
 按钮支持中英文混排，可以通过 `prefix`、`suffix` 插槽添加图标或附加文字。下面展示不同尺寸的组合，切换加载状态可查看加载图标与内容的排列。
@@ -1913,6 +2157,8 @@ const nativeAttrs1 = { "aria-label": "切换填充加载" } satisfies ButtonHTML
 
 按钮组只连接相邻边缘，保留两端的形状；只有一个按钮时仍保留完整圆角。
 
+circle 与 block 同用时保持圆形等宽高；普通纯图标与 block 同用时撑满父宽。按钮组中无边框、subtle 和 text 形态不自动补左侧分隔边框。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -5209,6 +5455,38 @@ import { Alert } from 'x-next';
 </template>
 ```
 
+### 暗色主题
+
+暗色提示与 Button 状态按钮、Link 悬浮背景及反馈图标底使用同组状态配色，正文保持浅色，图标保留类型辨识度。`normal` 继续使用中性弱提示背景。下面通过 ConfigProvider 展示局部暗色，页面主题切换时也会应用相同配色。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { Alert as XAlert, ConfigProvider as XConfigProvider } from 'x-next';
+import 'x-next/style/base.css';
+import 'x-next/style/alert.css';
+</script>
+<template>
+<XConfigProvider :dark="true" class="alert-dark-example">
+    <XAlert type="info">用于普通信息提示。</XAlert>
+    <XAlert type="success">用于成功状态反馈。</XAlert>
+    <XAlert type="warning">用于需要关注的警告信息。</XAlert>
+    <XAlert type="strong">用于需要强调的提醒信息。</XAlert>
+    <XAlert type="error">用于错误或失败信息。</XAlert>
+    <XAlert type="normal">用于弱提示或中性说明。</XAlert>
+  </XConfigProvider>
+</template>
+<style scoped>
+.alert-dark-example {
+  display: grid;
+  gap: 12px;
+  padding: 20px;
+  border-radius: 8px;
+  background: var(--x-color-bg-surface);
+}
+</style>
+```
+
 ### 标题
 
 ```vue
@@ -9010,6 +9288,474 @@ const nativeAttrs1 = { "aria-label": "键盘选择地区" } satisfies HTMLAttrib
 - 与 Arco 的差异：`checkedStrategy` 默认 `parent`（Arco 默认 `all`），并在其基础上提供 `child`；值可为 `labelInValue` 对象且附带 `raw` 原始节点，属于 x-next 的扩展。
 
 
+## Transfer 扩展场景
+
+### 用途与选型
+
+在两列列表之间移动数据，用于权限分配、成员分组和资源授权。
+
+
+### 何时使用
+
+- 同时查看候选与已分配数据，进行批量分配或取消分配。
+- 选项包含较多业务信息，Select 展开空间不足。
+- 自定义列表可以接入表格或树；层级关联与列表键盘逻辑由业务组合实现。
+
+
+### 基础用法与移动事件
+
+先勾选，再点击方向按钮。`change` 的第二参数是移动目的侧，第三参数仅包含实际移动值。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const basicValue = ref<TransferValue[]>(['audit']);
+  const basicData: TransferItem[] = [
+    { value: 'read', label: '查看数据' },
+    { value: 'edit', label: '编辑数据' },
+    { value: 'audit', label: '审核数据' },
+    { value: 'admin', label: '管理配置（不可分配）', disabled: true },
+  ];
+  const basicLog = ref('请勾选权限并移动');
+  function basicChange(value: TransferValue[], type: TransferType, moved: TransferValue[]) {
+    basicLog.value = `移至 ${type}：${moved.join(', ')}；当前值 ${JSON.stringify(value)}`;
+  }
+</script>
+<template>
+<Transfer
+    v-model="basicValue"
+    :data="basicData"
+    :title="['可分配权限', '已分配权限']"
+    @change="basicChange"
+  />
+  <p aria-live="polite">{{ basicLog }}</p>
+  <p>目标值：{{ basicValue }}</p>
+</template>
+```
+
+### 受控勾选与目标排序
+
+`v-model:selected-keys` 控制两侧临时勾选，与目标值独立。`target-order="append"` 以模型顺序展示目标项。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer, Button } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const checkedValue = ref<TransferValue[]>([2]);
+  const checkedKeys = ref<TransferValue[]>([1]);
+  const checkedData: TransferItem[] = Array.from({ length: 6 }, (_, index) => ({
+    value: index + 1,
+    label: `成员 ${index + 1}`,
+  }));
+  const checkedLog = ref('');
+  function checkedSelect(source: TransferValue[], target: TransferValue[]) {
+    checkedLog.value = `左侧 ${JSON.stringify(source)}；右侧 ${JSON.stringify(target)}`;
+  }
+</script>
+<template>
+<p
+    ><Button @click="checkedKeys = [1, 2, 3]">勾选成员 1 / 2 / 3</Button>
+    <Button @click="checkedKeys = []">取消所有勾选</Button></p
+  >
+  <Transfer
+    v-model="checkedValue"
+    v-model:selected-keys="checkedKeys"
+    :data="checkedData"
+    target-order="append"
+    @select="checkedSelect"
+  />
+  <p>目标：{{ checkedValue }}；勾选：{{ checkedKeys }}</p>
+  <p aria-live="polite">{{ checkedLog }}</p>
+</template>
+```
+
+### 搜索与过滤后的全选
+
+全选只作用于当前搜索结果，禁用项不参与；已勾选的隐藏项仍可以移动。自定义过滤可搜索附加业务字段。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const searchValue = ref<TransferValue[]>([]);
+  const searchData: TransferItem[] = [
+    { value: 'east-1', label: '杭州', region: '华东' },
+    { value: 'east-2', label: '上海', region: '华东' },
+    { value: 'north', label: '北京', region: '华北' },
+    { value: 'south', label: '深圳', region: '华南', disabled: true },
+  ];
+  const searchLog = ref('尝试搜索“华东”，然后全选');
+  function searchFilter(input: string, item: TransferItem) {
+    return `${item.label} ${String(item.region ?? '')}`.includes(input.trim());
+  }
+  function searchChanged(input: string, type: TransferType) {
+    searchLog.value = `${type} 搜索：${input || '已清空'}`;
+  }
+</script>
+<template>
+<Transfer
+    v-model="searchValue"
+    :data="searchData"
+    show-search
+    search-placeholder="搜索城市或大区"
+    :filter-option="searchFilter"
+    @search="searchChanged"
+  />
+  <p aria-live="polite">{{ searchLog }}</p>
+  <p>目标值：{{ searchValue }}</p>
+</template>
+```
+
+### 禁用、加载与错误状态
+
+加载时显示真实加载组件并阻止操作。单项禁用只影响该项；`error` 同时支持从 Form 继承。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer, Checkbox } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const stateValue = ref<TransferValue[]>([1]);
+  const stateDisabled = ref(false);
+  const stateLoading = ref(false);
+  const stateError = ref(false);
+  const stateData: TransferItem[] = [
+    { value: 1, label: '业务成员' },
+    { value: 2, label: '运维成员' },
+    { value: 3, label: '只读成员（禁用）', disabled: true },
+    { value: 4, label: '这是一个用于检查溢出省略和原生标题的超长成员名称' },
+  ];
+</script>
+<template>
+<p
+    ><Checkbox v-model="stateDisabled">禁用</Checkbox>
+    <Checkbox v-model="stateLoading">加载中</Checkbox>
+    <Checkbox v-model="stateError">错误</Checkbox></p
+  >
+  <Transfer
+    v-model="stateValue"
+    :data="stateData"
+    :disabled="stateDisabled"
+    :loading="stateLoading"
+    :error="stateError"
+    show-search
+  />
+</template>
+```
+
+### 单向分配与逐项移除
+
+只保留向右按钮，目标侧使用可通过键盘到达的移除按钮。已分配的禁用项不能移除。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const oneWayValue = ref<TransferValue[]>(['owner', 'viewer']);
+  const oneWayData: TransferItem[] = [
+    { value: 'owner', label: '固定负责人', disabled: true },
+    { value: 'viewer', label: '查看成员' },
+    { value: 'editor', label: '编辑成员' },
+  ];
+</script>
+<template>
+<Transfer v-model="oneWayValue" :data="oneWayData" one-way :operations="['分配']" />
+  <p>已分配：{{ oneWayValue }}</p>
+</template>
+```
+
+### 简单模式
+
+点击选项直接移动，也支持 Tab 与 Enter/Space。与 `one-way` 组合时，目标侧仍使用移除按钮。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const simpleValue = ref<TransferValue[]>(['b']);
+  const simpleData: TransferItem[] = [
+    { value: 'a', label: '开发组' },
+    { value: 'b', label: '产品组' },
+    { value: 'c', label: '测试组' },
+    { value: 'd', label: '归档组', disabled: true },
+  ];
+</script>
+<template>
+<Transfer v-model="simpleValue" :data="simpleData" simple />
+  <p>点击组名即可移动：{{ simpleValue }}</p>
+</template>
+```
+
+### 自定义选项、标题、图标和页脚
+
+item 仅替换内容，保留原生勾选交互。标题通过 `onSelectAllChange` 调用当前搜索结果/页内的全选。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer, Checkbox } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const slotValue = ref<TransferValue[]>([]);
+  const slotData: TransferItem[] = [
+    { value: 1, label: '林老师', role: '产品设计' },
+    { value: 2, label: '陈同学', role: '前端研发' },
+    { value: 3, label: '张同学', role: '质量保障' },
+  ];
+</script>
+<template>
+<Transfer
+    v-model="slotValue"
+    :data="slotData"
+    show-search
+    :title="['团队成员', '项目成员']"
+    :list-style="{ width: '260px' }"
+  >
+    <template #item="{ item }"
+      ><span>{{ item.label }} · {{ item.role }}</span></template
+    >
+    <template #source-title="{ title, checked, indeterminate, disabled, onSelectAllChange }">
+      <Checkbox
+        :model-value="checked"
+        :indeterminate="indeterminate"
+        :disabled="disabled"
+        @change="onSelectAllChange($event === true)"
+        >{{ title }}</Checkbox
+      >
+    </template>
+    <template #to-target-icon><span aria-hidden="true">→</span></template>
+    <template #to-source-icon><span aria-hidden="true">←</span></template>
+    <template #footer="{ type, data, selectedKeys }"
+      ><small
+        >{{ type === 'source' ? '可选' : '已选' }} {{ data.length }} 人，勾选
+        {{ selectedKeys.length }} 人</small
+      ></template
+    >
+  </Transfer>
+</template>
+```
+
+### 自定义列表
+
+source/target 替换列表内容。回调接入表格、树或业务卡片，保持共享移动规则。示例按钮支持键盘，并用 aria-pressed 表达勾选状态。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const customValue = ref<TransferValue[]>(['release']);
+  const customData: TransferItem[] = [
+    { value: 'design', label: '设计评审' },
+    { value: 'develop', label: '研发联调' },
+    { value: 'release', label: '上线验证' },
+    { value: 'archived', label: '已归档', disabled: true },
+  ];
+</script>
+<template>
+<Transfer v-model="customValue" :data="customData" show-search>
+    <template #source="{ pageData, selectedKeys, disabled, onSelect }">
+      <div style="padding: 12px; display: grid; gap: 8px">
+        <button
+          v-for="item in pageData"
+          :key="item.value"
+          type="button"
+          :disabled="disabled || item.disabled"
+          :aria-pressed="selectedKeys.includes(item.value)"
+          @click="onSelect(item.value, !selectedKeys.includes(item.value))"
+        >
+          {{ selectedKeys.includes(item.value) ? '✓ ' : '+ ' }}{{ item.label }}
+        </button>
+        <span v-if="!pageData.length">没有可选任务</span>
+      </div>
+    </template>
+    <template #target="{ pageData, selectedKeys, disabled, onSelect }">
+      <div style="padding: 12px; display: grid; gap: 8px">
+        <button
+          v-for="item in pageData"
+          :key="item.value"
+          type="button"
+          :disabled="disabled || item.disabled"
+          :aria-pressed="selectedKeys.includes(item.value)"
+          @click="onSelect(item.value, !selectedKeys.includes(item.value))"
+        >
+          {{ selectedKeys.includes(item.value) ? '✓ ' : '+ ' }}{{ item.label }}
+        </button>
+        <span v-if="!pageData.length">尚未分配任务</span>
+      </div>
+    </template>
+  </Transfer>
+  <p>当前项目任务：{{ customValue }}</p>
+</template>
+```
+
+### 分页
+
+两侧页码独立，全选仅当前页。搜索或每页条数变化后回到第一页，移动使页码超出范围时自动收敛。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const pagedValue = ref<TransferValue[]>([2, 4]);
+  const pagedData: TransferItem[] = Array.from({ length: 30 }, (_, index) => ({
+    value: index + 1,
+    label: `候选成员 ${index + 1}`,
+    disabled: index === 8,
+  }));
+</script>
+<template>
+<Transfer v-model="pagedValue" :data="pagedData" :pagination="{ pageSize: 5 }" show-search />
+  <p>已分配：{{ pagedValue }}</p>
+</template>
+```
+
+### 虚拟滚动
+
+大数据列表复用库内 VirtualList。分页优先于虚拟滚动；自定义列表自行决定渲染方式。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const virtualValue = ref<TransferValue[]>([100, 500]);
+  const virtualData: TransferItem[] = Array.from({ length: 1000 }, (_, index) => ({
+    value: index + 1,
+    label: `数据项 ${index + 1}`,
+  }));
+  const virtualLog = ref('尝试滚动列表或搜索数据项 999');
+  function virtualScroll(_event: Event, type: TransferType) {
+    virtualLog.value = `${type} 列表正在滚动`;
+  }
+</script>
+<template>
+<Transfer
+    v-model="virtualValue"
+    :data="virtualData"
+    show-search
+    :virtual-list-props="{
+      height: 240,
+      threshold: 30,
+      fixedSize: true,
+      estimatedSize: 36,
+      buffer: 5,
+    }"
+    @scroll="virtualScroll"
+  />
+  <p aria-live="polite">{{ virtualLog }}</p>
+  <p>目标值：{{ virtualValue }}</p>
+</template>
+```
+
+### Form 校验联动
+
+勾选和搜索不改变字段值；实际移动才触发 change 校验。标签/必填/错误说明绑定到整个组，内部控件不会重复注册。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { reactive, ref } from 'vue';
+  import { Transfer, Button, FormItem, Form } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const transferFormRef = ref<FormInstance>();
+  const transferForm = reactive({ members: [] as TransferValue[] });
+  const transferRules: Record<string, FieldRule[]> = {
+    members: [{ type: 'array', required: true, minLength: 2, message: '请至少分配 2 个成员' }],
+  };
+  const transferFormData: TransferItem[] = [
+    { value: 'lin', label: '林老师' },
+    { value: 'chen', label: '陈同学' },
+    { value: 'zhang', label: '张同学' },
+  ];
+  const transferFormLog = ref('');
+  async function validateTransfer() {
+    transferFormLog.value = (await transferFormRef.value?.validate()) ? '请补齐成员' : '校验通过';
+  }
+</script>
+<template>
+<Form ref="transferFormRef" :model="transferForm" :rules="transferRules" layout="vertical">
+    <FormItem field="members" label="项目成员" required>
+      <Transfer v-model="transferForm.members" :data="transferFormData" show-search />
+    </FormItem>
+    <Button type="primary" @click="validateTransfer">校验成员</Button>
+    <Button @click="transferFormRef?.resetFields()">重置</Button>
+    <p aria-live="polite">{{ transferFormLog }}</p>
+  </Form>
+</template>
+```
+
+### 空态与异步数据
+
+模型中暂时没有对应数据的值会保留，数据到达后展示。空态插槽能区分源侧、目标侧和搜索条件。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+const searchValue = ref<TransferValue[]>([]);
+
+  import { reactive, ref } from 'vue';
+  import { Transfer, Button } from 'x-next';
+  import type { TransferItem, TransferValue, TransferType, FormInstance, FieldRule } from 'x-next';
+  const emptyValue = ref<TransferValue[]>(['remote']);
+  const emptyData = ref<TransferItem[]>([]);
+  function loadTransferData() {
+    emptyData.value = [
+      { value: 'remote', label: '已分配的远程成员' },
+      { value: 'new', label: '新加载的候选成员' },
+    ];
+  }
+</script>
+<template>
+<p
+    ><Button @click="loadTransferData">加载模拟数据</Button>
+    <Button @click="emptyData = []">清空数据源</Button></p
+  >
+  <Transfer v-model="emptyValue" :data="emptyData" show-search>
+    <template #empty="{ type, searchValue }"
+      ><span>{{
+        searchValue ? '没有匹配的成员' : type === 'source' ? '暂无候选成员' : '暂无已加载成员'
+      }}</span></template
+    >
+  </Transfer>
+  <p>模型值保留：{{ emptyValue }}</p>
+</template>
+```
+
+### 键盘与行为边界
+
+- Tab 到达搜索、全选、选项和方向按钮；Space 勾选复选框，Enter/Space 激活方向/移除/简单模式按钮。
+- 默认列表支持 ↑ / ↓、Home / End 定位，跳过禁用项。自定义列表由业务实现键盘语义。
+- 勾选值与目标值分别受控；传入模型而不回写时保持原值。默认值只在创建时初始化。
+- `value` 必须全局唯一，数字 `1` 和字符串 `"1"` 不同。重复项保留首项，非法值不展示；不原地修改输入数组。
+- 默认搜索不区分大小写。全选仅当前搜索结果，分页时仅当前页；已勾选的搜索隐藏项仍参与移动。
+- 禁用项不能全选、移入或移除。缺失数据的目标值在移动其他项时保留。
+- `targetOrder="original"` 按数据源排序；`append` 按模型顺序，移入值追加在已有目标值之后。
+- `pagination` 优先于 `virtualListProps`。source/target 插槽接收过滤数据和当前页数据，自行实现虚拟渲染与键盘。
+- 数组控件没有 readonly 属性；只读展示可使用 disabled。字段映射、远程分页、拖拽排序需业务适配。
+
+
+### 数据类型
+
+组合参见 [Form 表单](./form.md)、[Checkbox 复选框](./checkbox.md)、[Table 表格](./table.md)、[TreeSelect 树选择器](./tree-select.md)。
+
+
 ## Empty 扩展场景
 
 ### 用途与选型
@@ -19227,13 +19973,12 @@ interface BarChartLayout {
 | loadingFill | 加载时居中覆盖内容并保持尺寸；结束后恢复文字和插槽 | undefined &#124; false &#124; true | 否 | false |
 | debounce | 点击后保持 loading 态的时间，单位 ms，用于防重复点击 | undefined &#124; number | 否 | 0 |
 | shape | 胶囊形、圆形或直角；未设置时使用默认圆角 | undefined &#124; "round" &#124; "circle" &#124; "square" | 否 | undefined |
-| link | 是否展示为链接按钮样式 | undefined &#124; false &#124; true | 否 | false |
-| type | 按钮类型 | undefined &#124; "default" &#124; "primary" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | "default" |
+| type | 按钮形态；primary 是实心形态的快捷类型，默认使用品牌色 | undefined &#124; "default" &#124; "primary" &#124; "solid" &#124; "subtle" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | "default" |
 | htmlType | 原生按钮类型；模板中使用 html-type | undefined &#124; "button" &#124; "submit" &#124; "reset" | 否 | "button" |
-| status | 按钮状态 | undefined &#124; "default" &#124; "success" &#124; "warning" &#124; "strong" &#124; "info" &#124; "danger" | 否 | "default" |
-| plain | 是否朴素样式 | undefined &#124; false &#124; true | 否 | false |
+| status | 按钮颜色 | undefined &#124; "default" &#124; "success" &#124; "warning" &#124; "strong" &#124; "info" &#124; "primary" &#124; "danger" | 否 | "default" |
+| plain | 将 default / solid / primary 改为弱底，保留颜色 | undefined &#124; false &#124; true | 否 | false |
 | size | 按钮尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" &#124; "huge" | 否 | undefined |
-| border | 是否显示边框 | undefined &#124; false &#124; true | 否 | true |
+| border | 是否允许形态的边框；false 只隐藏边框 | undefined &#124; false &#124; true | 否 | true |
 | narrow | 是否使用窄按钮，无内边距 | undefined &#124; false &#124; true | 否 | false |
 
 ### Events
@@ -19249,7 +19994,7 @@ interface BarChartLayout {
 | default | 按钮内容 | () => any |
 | prefix | 前置内容 | () => any |
 | suffix | 后置内容 | () => any |
-| icon | 图标内容，会渲染在文字前；仅有此插槽时按钮等宽高，请设置 aria-label | any |
+| icon | 图标内容，会渲染在文字前；仅有此插槽时通常等宽高，block 时撑满父宽；请设置 aria-label | any |
 
 ### 实例方法
 
@@ -19262,9 +20007,9 @@ interface BarChartLayout {
 ```typescript-reference
 type ButtonSize = 'mini' | 'small' | 'medium' | 'large' | 'huge';
 
-type ButtonStatus = 'default' | 'success' | 'warning' | 'strong' | 'danger' | 'info';
+type ButtonStatus = 'default' | 'primary' | 'success' | 'warning' | 'strong' | 'danger' | 'info';
 
-type ButtonTypes = 'primary' | 'default' | 'dashed' | 'outline' | 'text';
+type ButtonTypes = 'primary' | 'default' | 'solid' | 'subtle' | 'dashed' | 'outline' | 'text';
 
 type ButtonHtmlType = 'button' | 'submit' | 'reset';
 
@@ -19277,7 +20022,6 @@ type ButtonProps = {
     loadingFill?: boolean;
     debounce?: number;
     shape?: ButtonShape;
-    link?: boolean;
     type?: ButtonTypes;
     htmlType?: ButtonHtmlType;
     status?: ButtonStatus;
@@ -19297,11 +20041,11 @@ type ButtonProps = {
 
 | 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
 | --- | --- | --- | --- | --- |
-| type | 子按钮默认类型 | undefined &#124; "default" &#124; "primary" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | 未声明 |
-| status | 子按钮默认状态 | undefined &#124; "default" &#124; "success" &#124; "warning" &#124; "strong" &#124; "info" &#124; "danger" | 否 | 未声明 |
+| type | 子按钮默认类型 | undefined &#124; "default" &#124; "primary" &#124; "solid" &#124; "subtle" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | 未声明 |
+| status | 子按钮默认状态 | undefined &#124; "default" &#124; "success" &#124; "warning" &#124; "strong" &#124; "info" &#124; "primary" &#124; "danger" | 否 | 未声明 |
 | shape | 子按钮默认形状 | undefined &#124; "round" &#124; "circle" &#124; "square" | 否 | 未声明 |
 | size | 子按钮默认尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" &#124; "huge" | 否 | 未声明 |
-| disabled | 是否禁用所有子按钮 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
+| disabled | 子按钮默认禁用值；子按钮显式值优先 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
 
 ### Events
 
@@ -19322,9 +20066,9 @@ type ButtonProps = {
 ```typescript-reference
 type ButtonSize = 'mini' | 'small' | 'medium' | 'large' | 'huge';
 
-type ButtonStatus = 'default' | 'success' | 'warning' | 'strong' | 'danger' | 'info';
+type ButtonStatus = 'default' | 'primary' | 'success' | 'warning' | 'strong' | 'danger' | 'info';
 
-type ButtonTypes = 'primary' | 'default' | 'dashed' | 'outline' | 'text';
+type ButtonTypes = 'primary' | 'default' | 'solid' | 'subtle' | 'dashed' | 'outline' | 'text';
 
 type ButtonHtmlType = 'button' | 'submit' | 'reset';
 
@@ -19337,7 +20081,6 @@ type ButtonProps = {
     loadingFill?: boolean;
     debounce?: number;
     shape?: ButtonShape;
-    link?: boolean;
     type?: ButtonTypes;
     htmlType?: ButtonHtmlType;
     status?: ButtonStatus;
@@ -20177,8 +20920,8 @@ interface UseDraggableOptions<T> extends Options {
 | okText | 确认按钮文案 | undefined &#124; string | 否 | "" |
 | cancelText | 取消按钮文案 | undefined &#124; string | 否 | "" |
 | okLoading | 确认按钮是否 loading | undefined &#124; false &#124; true | 否 | false |
-| okButtonProps | 确认按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; link?: boolean; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
-| cancelButtonProps | 取消按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; link?: boolean; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
+| okButtonProps | 确认按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
+| cancelButtonProps | 取消按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
 | hideCancel | 是否隐藏默认取消按钮 | undefined &#124; false &#124; true | 否 | false |
 | onBeforeOk | 确认前拦截，返回 false 阻止关闭 | undefined &#124; (event?: Event) => boolean &#124; void &#124; Promise<boolean &#124; void> | 否 | 未声明 |
 | onBeforeCancel | 取消前拦截，返回 false 阻止关闭 | undefined &#124; (event?: Event) => boolean &#124; void &#124; Promise<boolean &#124; void> | 否 | 未声明 |
@@ -20351,9 +21094,9 @@ interface DropdownPanelRef {
 | position | 弹出位置 | undefined &#124; "top" &#124; "bottom" &#124; "tl" &#124; "tr" &#124; "bl" &#124; "br" | 否 | "br" |
 | popupContainer | 弹出层挂载容器 | undefined &#124; string &#124; HTMLElement | 否 | 未声明 |
 | disabled | 是否禁用 | undefined &#124; false &#124; true | 否 | false |
-| type | 按钮类型 | undefined &#124; "default" &#124; "primary" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | "default" |
+| type | 按钮类型 | undefined &#124; "default" &#124; "primary" &#124; "solid" &#124; "subtle" &#124; "dashed" &#124; "outline" &#124; "text" | 否 | "default" |
 | size | 按钮尺寸 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" &#124; "huge" | 否 | "medium" |
-| buttonProps | 左侧主按钮属性 | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; link?: boolean; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
+| buttonProps | 左侧主按钮属性 | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
 | hideOnSelect | 选择后是否隐藏弹出层 | undefined &#124; false &#124; true | 否 | true |
 
 ### Events
@@ -26988,7 +27731,7 @@ interface ActionType {
 | disabled | 禁用输入和搜索按钮 | undefined &#124; false &#124; true | 否 | false |
 | size | 尺寸，继承 Form / 全局配置 | undefined &#124; "mini" &#124; "small" &#124; "medium" &#124; "large" | 否 | 未声明 |
 | buttonText | 搜索按钮文字 | undefined &#124; string | 否 | 未声明 |
-| buttonProps | 搜索按钮属性 | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; link?: boolean; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
+| buttonProps | 搜索按钮属性 | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
 | modelValue | 见场景用法与类型 | undefined &#124; string | 否 | 透传内层组件；默认值见对应组件 |
 | type | 见场景用法与类型 | undefined &#124; "text" &#124; "password" | 否 | 透传内层组件；默认值见对应组件 |
 | error | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
@@ -28977,8 +29720,8 @@ interface PieChartSegment {
 | okText | 确认按钮文案 | undefined &#124; string | 否 | undefined |
 | cancelText | 取消按钮文案 | undefined &#124; string | 否 | undefined |
 | okLoading | 确认按钮是否为 loading | undefined &#124; false &#124; true | 否 | false |
-| okButtonProps | 确认按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; link?: boolean; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
-| cancelButtonProps | 取消按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; link?: boolean; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
+| okButtonProps | 确认按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
+| cancelButtonProps | 取消按钮 props | undefined &#124; { disabled?: boolean; block?: boolean; loading?: boolean; loadingFill?: boolean; debounce?: number; shape?: ButtonShape; type?: ButtonTypes; htmlType?: ButtonHtmlType; status?: ButtonStatus; plain?: boolean; size?: ButtonSize; border?: boolean; narrow?: boolean; } | 否 | 未声明 |
 | onBeforeOk | 确认前拦截，返回 false 阻止关闭；返回 Promise 时确认按钮进入 loading | undefined &#124; (e: Event) => boolean &#124; void &#124; Promise<boolean &#124; void> | 否 | undefined |
 | onBeforeCancel | 取消前拦截，返回 false 阻止关闭；返回 Promise 时取消按钮进入 loading | undefined &#124; (e: Event) => boolean &#124; void &#124; Promise<boolean &#124; void> | 否 | undefined |
 | renderTo | 弹层挂载容器 | undefined &#124; string &#124; HTMLElement | 否 | 未声明 |
@@ -33752,7 +34495,7 @@ type Filters = Record<string, string[]>;
 | 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
 | --- | --- | --- | --- | --- |
 | reverse | 是否倒序展示 | undefined &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
-| lineType | 轴线样式 | undefined &#124; "dashed" &#124; "dotted" &#124; "solid" | 否 | "solid" |
+| lineType | 轴线样式 | undefined &#124; "solid" &#124; "dashed" &#124; "dotted" | 否 | "solid" |
 | direction | 时间线方向 | undefined &#124; "horizontal" &#124; "vertical" | 否 | "vertical" |
 | mode | 展示模式 | undefined &#124; "top" &#124; "bottom" &#124; "right" &#124; "left" &#124; "alternate" | 否 | "left" |
 | pending | 是否展示幽灵节点，传入字符串时作为节点内容展示 | undefined &#124; string &#124; false &#124; true | 否 | false（Vue Boolean 转换） |
@@ -33805,7 +34548,7 @@ type TimelineItemPosition = 'left' | 'right' | 'top' | 'bottom';
 | label | 标签文本 | undefined &#124; string | 否 | 未声明 |
 | dotColor | 时间点颜色 | undefined &#124; string & {} &#124; "initial" &#124; "red" &#124; "orangered" &#124; "orange" &#124; "gold" &#124; "lime" &#124; "green" &#124; "cyan" &#124; "blue" &#124; "purple" &#124; "magenta" &#124; "gray" &#124; "-moz-initial" &#124; "inherit" &#124; "revert" &#124; "revert-layer" &#124; "unset" &#124; "aliceblue" &#124; "antiquewhite" &#124; "aqua" &#124; "aquamarine" &#124; "azure" &#124; "beige" &#124; "bisque" &#124; "black" &#124; "blanchedalmond" &#124; "blueviolet" &#124; "brown" &#124; "burlywood" &#124; "cadetblue" &#124; "chartreuse" &#124; "chocolate" &#124; "coral" &#124; "cornflowerblue" &#124; "cornsilk" &#124; "crimson" &#124; "darkblue" &#124; "darkcyan" &#124; "darkgoldenrod" &#124; "darkgray" &#124; "darkgreen" &#124; "darkgrey" &#124; "darkkhaki" &#124; "darkmagenta" &#124; "darkolivegreen" &#124; "darkorange" &#124; "darkorchid" &#124; "darkred" &#124; "darksalmon" &#124; "darkseagreen" &#124; "darkslateblue" &#124; "darkslategray" &#124; "darkslategrey" &#124; "darkturquoise" &#124; "darkviolet" &#124; "deeppink" &#124; "deepskyblue" &#124; "dimgray" &#124; "dimgrey" &#124; "dodgerblue" &#124; "firebrick" &#124; "floralwhite" &#124; "forestgreen" &#124; "fuchsia" &#124; "gainsboro" &#124; "ghostwhite" &#124; "goldenrod" &#124; "greenyellow" &#124; "grey" &#124; "honeydew" &#124; "hotpink" &#124; "indianred" &#124; "indigo" &#124; "ivory" &#124; "khaki" &#124; "lavender" &#124; "lavenderblush" &#124; "lawngreen" &#124; "lemonchiffon" &#124; "lightblue" &#124; "lightcoral" &#124; "lightcyan" &#124; "lightgoldenrodyellow" &#124; "lightgray" &#124; "lightgreen" &#124; "lightgrey" &#124; "lightpink" &#124; "lightsalmon" &#124; "lightseagreen" &#124; "lightskyblue" &#124; "lightslategray" &#124; "lightslategrey" &#124; "lightsteelblue" &#124; "lightyellow" &#124; "limegreen" &#124; "linen" &#124; "maroon" &#124; "mediumaquamarine" &#124; "mediumblue" &#124; "mediumorchid" &#124; "mediumpurple" &#124; "mediumseagreen" &#124; "mediumslateblue" &#124; "mediumspringgreen" &#124; "mediumturquoise" &#124; "mediumvioletred" &#124; "midnightblue" &#124; "mintcream" &#124; "mistyrose" &#124; "moccasin" &#124; "navajowhite" &#124; "navy" &#124; "oldlace" &#124; "olive" &#124; "olivedrab" &#124; "orchid" &#124; "palegoldenrod" &#124; "palegreen" &#124; "paleturquoise" &#124; "palevioletred" &#124; "papayawhip" &#124; "peachpuff" &#124; "peru" &#124; "pink" &#124; "plum" &#124; "powderblue" &#124; "rebeccapurple" &#124; "rosybrown" &#124; "royalblue" &#124; "saddlebrown" &#124; "salmon" &#124; "sandybrown" &#124; "seagreen" &#124; "seashell" &#124; "sienna" &#124; "silver" &#124; "skyblue" &#124; "slateblue" &#124; "slategray" &#124; "slategrey" &#124; "snow" &#124; "springgreen" &#124; "steelblue" &#124; "tan" &#124; "teal" &#124; "thistle" &#124; "tomato" &#124; "turquoise" &#124; "violet" &#124; "wheat" &#124; "white" &#124; "whitesmoke" &#124; "yellow" &#124; "yellowgreen" &#124; "transparent" &#124; "AccentColor" &#124; "AccentColorText" &#124; "ActiveText" &#124; "ButtonBorder" &#124; "ButtonFace" &#124; "ButtonText" &#124; "Canvas" &#124; "CanvasText" &#124; "Field" &#124; "FieldText" &#124; "GrayText" &#124; "Highlight" &#124; "HighlightText" &#124; "LinkText" &#124; "Mark" &#124; "MarkText" &#124; "SelectedItem" &#124; "SelectedItemText" &#124; "VisitedText" &#124; "ActiveBorder" &#124; "ActiveCaption" &#124; "AppWorkspace" &#124; "Background" &#124; "ButtonHighlight" &#124; "ButtonShadow" &#124; "CaptionText" &#124; "InactiveBorder" &#124; "InactiveCaption" &#124; "InactiveCaptionText" &#124; "InfoBackground" &#124; "InfoText" &#124; "Menu" &#124; "MenuText" &#124; "Scrollbar" &#124; "ThreeDDarkShadow" &#124; "ThreeDFace" &#124; "ThreeDHighlight" &#124; "ThreeDLightShadow" &#124; "ThreeDShadow" &#124; "Window" &#124; "WindowFrame" &#124; "WindowText" &#124; "currentColor" | 否 | 未声明 |
 | dotType | 时间点类型 | undefined &#124; "solid" &#124; "hollow" | 否 | "solid" |
-| lineType | 当前节点后的轴线样式 | undefined &#124; "dashed" &#124; "dotted" &#124; "solid" | 否 | 未声明 |
+| lineType | 当前节点后的轴线样式 | undefined &#124; "solid" &#124; "dashed" &#124; "dotted" | 否 | 未声明 |
 | lineColor | 当前节点后的轴线颜色 | undefined &#124; string & {} &#124; "initial" &#124; "red" &#124; "orangered" &#124; "orange" &#124; "gold" &#124; "lime" &#124; "green" &#124; "cyan" &#124; "blue" &#124; "purple" &#124; "magenta" &#124; "gray" &#124; "-moz-initial" &#124; "inherit" &#124; "revert" &#124; "revert-layer" &#124; "unset" &#124; "aliceblue" &#124; "antiquewhite" &#124; "aqua" &#124; "aquamarine" &#124; "azure" &#124; "beige" &#124; "bisque" &#124; "black" &#124; "blanchedalmond" &#124; "blueviolet" &#124; "brown" &#124; "burlywood" &#124; "cadetblue" &#124; "chartreuse" &#124; "chocolate" &#124; "coral" &#124; "cornflowerblue" &#124; "cornsilk" &#124; "crimson" &#124; "darkblue" &#124; "darkcyan" &#124; "darkgoldenrod" &#124; "darkgray" &#124; "darkgreen" &#124; "darkgrey" &#124; "darkkhaki" &#124; "darkmagenta" &#124; "darkolivegreen" &#124; "darkorange" &#124; "darkorchid" &#124; "darkred" &#124; "darksalmon" &#124; "darkseagreen" &#124; "darkslateblue" &#124; "darkslategray" &#124; "darkslategrey" &#124; "darkturquoise" &#124; "darkviolet" &#124; "deeppink" &#124; "deepskyblue" &#124; "dimgray" &#124; "dimgrey" &#124; "dodgerblue" &#124; "firebrick" &#124; "floralwhite" &#124; "forestgreen" &#124; "fuchsia" &#124; "gainsboro" &#124; "ghostwhite" &#124; "goldenrod" &#124; "greenyellow" &#124; "grey" &#124; "honeydew" &#124; "hotpink" &#124; "indianred" &#124; "indigo" &#124; "ivory" &#124; "khaki" &#124; "lavender" &#124; "lavenderblush" &#124; "lawngreen" &#124; "lemonchiffon" &#124; "lightblue" &#124; "lightcoral" &#124; "lightcyan" &#124; "lightgoldenrodyellow" &#124; "lightgray" &#124; "lightgreen" &#124; "lightgrey" &#124; "lightpink" &#124; "lightsalmon" &#124; "lightseagreen" &#124; "lightskyblue" &#124; "lightslategray" &#124; "lightslategrey" &#124; "lightsteelblue" &#124; "lightyellow" &#124; "limegreen" &#124; "linen" &#124; "maroon" &#124; "mediumaquamarine" &#124; "mediumblue" &#124; "mediumorchid" &#124; "mediumpurple" &#124; "mediumseagreen" &#124; "mediumslateblue" &#124; "mediumspringgreen" &#124; "mediumturquoise" &#124; "mediumvioletred" &#124; "midnightblue" &#124; "mintcream" &#124; "mistyrose" &#124; "moccasin" &#124; "navajowhite" &#124; "navy" &#124; "oldlace" &#124; "olive" &#124; "olivedrab" &#124; "orchid" &#124; "palegoldenrod" &#124; "palegreen" &#124; "paleturquoise" &#124; "palevioletred" &#124; "papayawhip" &#124; "peachpuff" &#124; "peru" &#124; "pink" &#124; "plum" &#124; "powderblue" &#124; "rebeccapurple" &#124; "rosybrown" &#124; "royalblue" &#124; "saddlebrown" &#124; "salmon" &#124; "sandybrown" &#124; "seagreen" &#124; "seashell" &#124; "sienna" &#124; "silver" &#124; "skyblue" &#124; "slateblue" &#124; "slategray" &#124; "slategrey" &#124; "snow" &#124; "springgreen" &#124; "steelblue" &#124; "tan" &#124; "teal" &#124; "thistle" &#124; "tomato" &#124; "turquoise" &#124; "violet" &#124; "wheat" &#124; "white" &#124; "whitesmoke" &#124; "yellow" &#124; "yellowgreen" &#124; "transparent" &#124; "AccentColor" &#124; "AccentColorText" &#124; "ActiveText" &#124; "ButtonBorder" &#124; "ButtonFace" &#124; "ButtonText" &#124; "Canvas" &#124; "CanvasText" &#124; "Field" &#124; "FieldText" &#124; "GrayText" &#124; "Highlight" &#124; "HighlightText" &#124; "LinkText" &#124; "Mark" &#124; "MarkText" &#124; "SelectedItem" &#124; "SelectedItemText" &#124; "VisitedText" &#124; "ActiveBorder" &#124; "ActiveCaption" &#124; "AppWorkspace" &#124; "Background" &#124; "ButtonHighlight" &#124; "ButtonShadow" &#124; "CaptionText" &#124; "InactiveBorder" &#124; "InactiveCaption" &#124; "InactiveCaptionText" &#124; "InfoBackground" &#124; "InfoText" &#124; "Menu" &#124; "MenuText" &#124; "Scrollbar" &#124; "ThreeDDarkShadow" &#124; "ThreeDFace" &#124; "ThreeDHighlight" &#124; "ThreeDLightShadow" &#124; "ThreeDShadow" &#124; "Window" &#124; "WindowFrame" &#124; "WindowText" &#124; "currentColor" | 否 | 未声明 |
 | position | 交替模式下的单项位置 | undefined &#124; "top" &#124; "bottom" &#124; "right" &#124; "left" | 否 | 未声明 |
 
@@ -34619,6 +35362,163 @@ type Filters = Record<string, string[]>;
 ```
 
 
+## Transfer API
+
+公开声明：`dist/components/transfer/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。
+
+### Props
+
+| 名称 | 用途 | 公开类型 | 必填 | 声明默认值 |
+| --- | --- | --- | --- | --- |
+| data | 数据源，value 唯一，支持附加字段 | undefined &#124; TransferItem[] | 否 | [] |
+| modelValue | 见场景用法与类型 | undefined &#124; TransferValue[] | 否 | undefined |
+| defaultValue | 非受控目标初始值 | undefined &#124; TransferValue[] | 否 | [] |
+| selectedKeys | 见场景用法与类型 | undefined &#124; TransferValue[] | 否 | undefined |
+| defaultSelectedKeys | 非受控勾选初始值 | undefined &#124; TransferValue[] | 否 | [] |
+| disabled | 禁用，继承 Form | undefined &#124; false &#124; true | 否 | false |
+| loading | 加载并阻止操作 | undefined &#124; false &#124; true | 否 | false |
+| error | 错误，继承 Form | undefined &#124; false &#124; true | 否 | false |
+| simple | 点击立即移动 | undefined &#124; false &#124; true | 否 | false |
+| oneWay | 单向分配，目标逐项移除 | undefined &#124; false &#124; true | 否 | false |
+| showSearch | 两侧搜索 | undefined &#124; false &#124; true | 否 | false |
+| showSelectAll | 显示全选；simple/oneWay 目标侧不显示 | undefined &#124; false &#124; true | 否 | true |
+| title | 两侧标题，缺项按语言包回退 | undefined &#124; string[] | 否 | 未声明 |
+| operations | 向右、向左操作文案 | undefined &#124; string[] | 否 | [] |
+| searchPlaceholder | 搜索占位 | undefined &#124; string | 否 | 未声明 |
+| filterOption | 非空搜索的过滤函数 | undefined &#124; (input: string, item: TransferItem, type: TransferType) => boolean | 否 | 未声明 |
+| targetOrder | 目标排序 | undefined &#124; "append" &#124; "original" | 否 | "original" |
+| listStyle | 面板样式，可设置 width 或组件 CSS token | undefined &#124; CSSProperties | 否 | 未声明 |
+| pagination | 分页，非法 pageSize 回退 10 | undefined &#124; false &#124; true &#124; TransferPagination | 否 | false |
+| virtualListProps | VirtualList 配置，默认高度 240 | undefined &#124; VirtualListProps | 否 | 未声明 |
+
+### Events
+
+| 事件 | 用途 | 监听器签名（即事件参数） |
+| --- | --- | --- |
+| update:modelValue | 请求更新目标模型 | undefined &#124; (_values: TransferValue[]) => any |
+| update:selectedKeys | 请求更新临时勾选模型 | undefined &#124; (_values: TransferValue[]) => any |
+| change | 实际移动，type 为目的侧 | undefined &#124; (_values: TransferValue[], _type: TransferType, _movedValues: TransferValue[]) => any |
+| select | 临时勾选变化或移动清除勾选 | undefined &#124; (_sourceSelected: TransferValue[], _targetSelected: TransferValue[]) => any |
+| search | 输入/清空/隐藏搜索重置 | undefined &#124; (_value: string, _type: TransferType) => any |
+| scroll | 列表滚动 | undefined &#124; (_event: Event, _type: TransferType) => any |
+
+### Slots
+
+| 名称 | 用途 | 公开类型 |
+| --- | --- | --- |
+| item | 选项内容 | undefined &#124; (props: TransferItemSlotProps) => VNodeChild |
+| source | 见场景用法与类型 | undefined &#124; (props: TransferListSlotProps) => VNodeChild |
+| target | 见场景用法与类型 | undefined &#124; (props: TransferListSlotProps) => VNodeChild |
+| source-title | 见场景用法与类型 | undefined &#124; (props: TransferTitleSlotProps) => VNodeChild |
+| target-title | 见场景用法与类型 | undefined &#124; (props: TransferTitleSlotProps) => VNodeChild |
+| footer | 两侧页脚 | undefined &#124; (props: TransferListSlotProps) => VNodeChild |
+| empty | 默认列表空态，自定义列表自行处理 | undefined &#124; (props: { type: TransferType; searchValue: string; }) => VNodeChild |
+| to-target-icon | 见场景用法与类型 | undefined &#124; () => VNodeChild |
+| to-source-icon | 见场景用法与类型 | undefined &#124; () => VNodeChild |
+| source / target | 替换对应侧列表 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| source-title / target-title | 替换标题 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+| to-target-icon / to-source-icon | 方向图标 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
+
+### 实例方法
+
+没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+
+### 关联类型定义
+
+以下摘自本组件族声明，供查阅嵌套配置；运行时和值类型均以根入口可导出项为准。
+
+```typescript-reference
+type TransferValue = string | number;
+
+type TransferType = 'source' | 'target';
+
+interface TransferItem {
+    value: TransferValue;
+    label: string;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+
+interface TransferPagination {
+    /** 每页条数，默认 10 */
+    pageSize?: number;
+}
+
+interface TransferProps {
+    data?: TransferItem[];
+    modelValue?: TransferValue[];
+    defaultValue?: TransferValue[];
+    selectedKeys?: TransferValue[];
+    defaultSelectedKeys?: TransferValue[];
+    disabled?: boolean;
+    loading?: boolean;
+    error?: boolean;
+    simple?: boolean;
+    oneWay?: boolean;
+    showSearch?: boolean;
+    showSelectAll?: boolean;
+    title?: string[];
+    operations?: string[];
+    searchPlaceholder?: string;
+    filterOption?: (inputValue: string, item: TransferItem, type: TransferType) => boolean;
+    targetOrder?: 'original' | 'append';
+    listStyle?: CSSProperties;
+    pagination?: boolean | TransferPagination;
+    virtualListProps?: VirtualListProps;
+}
+
+interface TransferListSlotProps {
+    type: TransferType;
+    /** 搜索过滤后的全部数据 */
+    data: TransferItem[];
+    /** 当前页数据，未分页时等于 data */
+    pageData: TransferItem[];
+    /** 本侧有效勾选值，包含搜索隐藏项 */
+    selectedKeys: TransferValue[];
+    disabled: boolean;
+    onSelect: (value: TransferValue, checked: boolean) => void;
+    onSelectAll: (values: TransferValue[], checked: boolean) => void;
+    onMove: (values: TransferValue[]) => void;
+}
+
+interface TransferTitleSlotProps {
+    type: TransferType;
+    title: string;
+    countTotal: number;
+    countSelected: number;
+    searchValue: string;
+    checked: boolean;
+    indeterminate: boolean;
+    disabled: boolean;
+    onSelectAllChange: (checked: boolean) => void;
+}
+
+interface TransferItemSlotProps {
+    item: TransferItem;
+    type: TransferType;
+    selected: boolean;
+    disabled: boolean;
+}
+
+interface TransferSlots {
+    item?: (props: TransferItemSlotProps) => VNodeChild;
+    source?: (props: TransferListSlotProps) => VNodeChild;
+    target?: (props: TransferListSlotProps) => VNodeChild;
+    'source-title'?: (props: TransferTitleSlotProps) => VNodeChild;
+    'target-title'?: (props: TransferTitleSlotProps) => VNodeChild;
+    footer?: (props: TransferListSlotProps) => VNodeChild;
+    empty?: (props: {
+        type: TransferType;
+        searchValue: string;
+    }) => VNodeChild;
+    'to-target-icon'?: () => VNodeChild;
+    'to-source-icon'?: () => VNodeChild;
+}
+
+type TransferInstance = InstanceType<typeof Transfer>;
+```
+
+
 ## TreeSelect API
 
 公开声明：`dist/components/tree-select/index.d.ts`。 类型中的 undefined 表示可省略；原始 prop 默认值不等于继承配置或服务默认值。