x-next 1.17.0 → 1.18.1

package/AI_USAGE.md

@@ -1,9 +1,9 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # x-next AI 使用手册
 
-适用版本：**x-next@1.17.0**。Vue：`^3.5.0`；Node：`>=20.19.0`。
+适用版本：**x-next@1.18.1**。Vue：`^3.5.0`；Node：`>=20.19.0`。
 
-来源指纹（AI 行为说明、docs 导入快照、映射、样式依赖、版本、公开类型和 API 参考）：`cb20ad6ab74abb988edda3dcdead384d76be5bf5f8d346414b20974fc2b6ac68`。
+来源指纹（AI 行为说明、docs 导入快照、映射、样式依赖、版本、公开类型和 API 参考）：`5a7a6ac6864f5c967d7414c6cb2bf7b0470f3208f35e8ece68ed34b3b2716d83`。
 
 覆盖 59 个组件族与 106 个公开组件/服务导出。优先通过 [本地按需索引](./AI_USAGE/index.md) 读取组件页和 API，不为查本包用法默认搜索网络。
 
@@ -226,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`。
 
@@ -534,6 +534,8 @@ function restore() { visible.value = true; feedback.value = '提示显示中'; }
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/dialog)。从根入口导入 `DialogComponent as XDialog`，普通 `v-model` 为布尔值且默认 `false`。`renderTo='body'`、`mask=true`、`maskToClose=true`、`escToClose=true`、`destroyOnClosed=true`；`width` 支持数字或 CSS 长度。
 
+声明式组件默认 `center=false`、`top='100px'`，`top` 仅在非居中、非全屏时生效；命令式 `Dialog(options)` 保持默认居中，其服务默认 `top=0`。
+
 `title`、默认正文、`footer` 是公开插槽，默认不生成业务按钮。`close(action, event?)` 的 action 为 `'cancel' | 'ok'`，`closed` 表示关闭动画结束；直接改模型不会调用业务取消逻辑。根入口服务 `Dialog(options)` 返回 `close()` / `update(options)` 句柄。
 
 ```vue
@@ -680,6 +682,8 @@ function cancel(_event: Event) { feedback.value = '已取消删除'; }
 
 `popup-visible-change(visible)` 返回布尔值，`show` / `hide` 无参数。点击触发器或外部默认可以关闭；`popupContainer` 和 `renderToBody` 决定宿主，用于定位、滚动及裁剪。通过 ConfigProvider 配置的主题会由 Trigger 同步到浮层根，默认挂到 body 也生效；任意业务 CSS 变量或仅在局部 DOM 调用 applyThemeColor 不等于该注入协议，仍要核对实际继承。
 
+Escape 从触发器、内容或鼠标打开后的 body 焦点关闭当前最上层 Popover，并归还触发器焦点；组合输入期间保留浮层。关闭和卸载会清理键盘监听，focus 触发模式不会因焦点归还重新打开。
+
 ```vue
 <script setup lang="ts">
 import { ref } from 'vue';
@@ -730,7 +734,7 @@ function advance() { percent.value = Math.min(1, percent.value + 0.25); }
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/dropdown)。使用 `v-model:popup-visible`，默认 `trigger='click'`、`position='bottom'`、`hideOnSelect=true`。根入口导出 `DropdownOption`、`DropdownGroup`、`DropdownSubmenu`；菜单内容放 `content` 插槽，另有 `empty` / `footer` 插槽。
 
-`select(value, event)` 返回 `string | number | Record<string, any> | undefined` 和 `Event`，`popup-visible-change` 返回布尔值。选项支持 `disabled`；字符搜索 typeahead、自定义控件的通用键盘代理及 Tab 自动关闭仍有边界，不能据方向键导航推断这些能力已实现。
+`select(value, event)` 返回 `string | number | Record<string, any> | undefined` 和 `Event`，`popup-visible-change` 返回布尔值。选项支持 `disabled`；Tab / Shift+Tab 从触发器、菜单项或子菜单退出根菜单，并从根触发器继续浏览器默认顺序导航。字符搜索 typeahead、自定义控件的通用键盘代理仍有边界，不能据方向键导航推断这些能力已实现。
 
 ```vue
 <script setup lang="ts">
@@ -1576,14 +1580,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">
@@ -1595,6 +1726,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>
@@ -1602,6 +1734,8 @@ import { Button } from 'x-next';
 
 ### 状态
 
+通过 `status` 表达成功、警告、危险等状态。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -1619,15 +1753,45 @@ import { Button } from 'x-next';
 </template>
 ```
 
-### 状态色实心按钮
+### 暗色状态按钮
 
-五种状态色都提供实心（高亮）形态，**统一使用白字**与主题惯例一致。实心底色即主题种子色：主要 `#1c61ff`、成功 `#00a809`、警告 `#ffb800`、强调 `#ff8200`、危险 `#e02225`。
+通过 `ConfigProvider` 的 `dark` 属性设置局部暗色。
+
+```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>
+```
 
-危险色种子 `#e02225` 的白字对比为 4.75:1，实心底直接使用种子本身，不再需要压暗变体。
+### 状态色实心按钮
 
-实心底与白字在明暗主题下都恒定不翻转，因此暗色下仍是同一块强调色。更换主题种子色（`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">
@@ -1646,25 +1810,11 @@ import { Button } from 'x-next';
 
 ### 类型与边框
 
-`border="false"` 使用弱背景状态色，不会切换成实心危险按钮。需要实心危险按钮时使用 `type="primary" status="danger"`。
+`:border="false"` 只隐藏边框。需要弱底危险按钮时使用 `type="subtle" status="danger"`，实心危险按钮使用 `type="solid" status="danger"`。
 
-`link` 保持透明背景和对应状态文字色，非圆形链接按钮的高度随文字行高变化、没有水平内边距。禁用和加载期间不会响应悬浮或按下颜色。
+### 交互状态
 
-彩色文字按钮（`plain`、`outline`、`text`、`link`）在亮色主题中沿用品牌主色，暗色主题中使用同色系的亮色档，与 Link、Tag 同源。对比度下限对齐 Arco 同级角色，由 `script/check-contrast.js` 的 `ARCO_BASELINE` 守护。
-
-### 交互三态
-
-按钮的常态、悬浮、按下按**渐深梯度**设计，每一级都可感知且保持轻盈（明度差 ≥ 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">
@@ -1678,15 +1828,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';
 
-Button 的状态色基于组件 alias token 组织，例如 `--x-button-color-bg-danger-subtle`、`--x-button-color-bg-danger-solid`、`--x-button-color-text-danger`。后续自定义主题可以优先覆盖这些组件级 token。
+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>
+```
+
+### 状态矩阵
 
 ```vue
 <script setup lang="ts">
@@ -1729,7 +1916,7 @@ const sizes = ['mini', 'small', 'medium', 'large', 'huge'] as const;
 
 ### 尺寸
 
-`mini`、`small`、`medium`、`large`、`huge` 的默认高度分别为 24、28、32、36、38px。
+`mini`、`small`、`medium`、`large`、`huge` 的默认高度分别为 24、28、32、36、38px，字号分别为 12、13、14、15、16px。
 
 以下为默认主题中的尺寸规格；链接和形状选项会按对应规则调整布局。
 
@@ -1738,8 +1925,8 @@ const sizes = ['mini', 'small', 'medium', 'large', 'huge'] as const;
 | `mini` | 24px | 12px | 500 | 8px | 4px |
 | `small` | 28px | 13px | 500 | 10px | 4px |
 | `medium` | 32px | 14px | 500 | 14px | 4px |
-| `large` | 36px | 14px | 500 | 20px | 6px |
-| `huge` | 38px | 16px | 500 | 28px | 6px |
+| `large` | 36px | 15px | 500 | 16px | 6px |
+| `huge` | 38px | 16px | 500 | 20px | 6px |
 
 ```vue
 <script setup lang="ts">
@@ -1798,6 +1985,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';
@@ -1815,6 +2011,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` 插槽添加图标或附加文字。下面展示不同尺寸的组合，切换加载状态可查看加载图标与内容的排列。
@@ -1948,6 +2161,8 @@ const nativeAttrs1 = { "aria-label": "切换填充加载" } satisfies ButtonHTML
 
 按钮组只连接相邻边缘，保留两端的形状；只有一个按钮时仍保留完整圆角。
 
+circle 与 block 同用时保持圆形等宽高；普通纯图标与 block 同用时撑满父宽。按钮组中无边框、subtle 和 text 形态不自动补左侧分隔边框。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -4658,6 +4873,10 @@ const range = ref(['2026-06-01', '2026-06-30']);
 
 ### 中国农历展示
 
+### 农历空辅助行和禁用状态
+
+只显示节日和节气时，部分日期没有辅助文案；数字、选中圆圈和范围色带仍共用同一日期区。周末禁用时，数字与农历文字一同弱化，包括绑定值已命中禁用日期的情况。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -4676,6 +4895,24 @@ const range = ref(['2026-06-19', '2026-09-25']);
 </template>
 ```
 
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { RangePicker, DatePicker } from 'x-next';
+import { ref } from 'vue';
+const range = ref(['2026-06-19', '2026-07-07']);
+const date = ref('2026-06-20');
+const disabledDate = (current: Date) => [0, 6].includes(current.getDay());
+import type { HTMLAttributes } from 'vue';
+const nativeAttrs1 = { "aria-label": "节日节气范围" } satisfies HTMLAttributes;
+const nativeAttrs2 = { "aria-label": "农历日期" } satisfies HTMLAttributes;
+</script>
+<template>
+<RangePicker v-bind="nativeAttrs1" v-model="range" :show-lunar="{ showLunarDate: false }"  />
+  <DatePicker v-bind="nativeAttrs2" v-model="date" show-lunar :disabled-date="disabledDate"  />
+</template>
+```
+
 ### 带时间的日期选择
 
 ```vue
@@ -4693,6 +4930,51 @@ const dateTimeRange = ref(['2026-06-02 00:00:00', '2026-07-29 09:09:06']);
 </template>
 ```
 
+### 手输与禁用规则
+
+第一项可输入 `2026-06-06`（禁用周末）或 `2026-02-31`（不存在的日期），按 Enter 后会恢复原值。第二项可输入 `2026-06-04 15:46:12`，提交后保留时分秒；0–8 时和每小时 30 分不可选，也不能通过手输提交。`disabledTime` 按字段覆盖 `timePickerProps` 中的时间禁用函数。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { DatePicker } from 'x-next';
+import { ref } from 'vue';
+const date = ref('2026-06-04');
+const dateTime = ref('2026-06-04 09:15:00');
+const log = ref('等待有效提交');
+const disabledDate = (current: Date) => [0, 6].includes(current.getDay());
+const timeProps = { disabledHours: () => [0, 1, 2, 3, 4, 5, 6, 7, 8] };
+const disabledTime = () => ({ disabledMinutes: () => [30] });
+import type { HTMLAttributes } from 'vue';
+const nativeAttrs1 = { "aria-label": "预约日期" } satisfies HTMLAttributes;
+const nativeAttrs2 = { "aria-label": "预约日期时间" } satisfies HTMLAttributes;
+</script>
+<template>
+<DatePicker v-bind="nativeAttrs1" v-model="date" :disabled-date="disabledDate"  />
+  <DatePicker v-bind="nativeAttrs2" v-model="dateTime" show-time :time-picker-props="timeProps" :disabled-time="disabledTime"  @change="log = `提交：${$event}`" />
+  <p>{{ date }}；{{ dateTime }}；{{ log }}</p>
+</template>
+```
+
+### 周一起始的周选择
+
+周选择的网格、点击、手输和提交保持相同的周起始日。下方可输入 `2026-40th`，或选择 2026 年 9 月 28 日到 10 月 4 日中的任一天，再重新打开确认高亮行。
+
+```vue
+<script setup lang="ts">
+import 'x-next/style.css';
+import { WeekPicker } from 'x-next';
+import { ref } from 'vue';
+const week = ref('2026-40th');
+import type { HTMLAttributes } from 'vue';
+const nativeAttrs1 = { "aria-label": "排期周" } satisfies HTMLAttributes;
+</script>
+<template>
+<WeekPicker v-bind="nativeAttrs1" v-model="week" :day-start-of-week="1"  />
+  <p>{{ week }}</p>
+</template>
+```
+
 ### 月范围和受控面板
 
 ```vue
@@ -4765,18 +5047,24 @@ const date = ref('2026-09-30');
 
 ### 状态
 
+范围仅禁用一端时，面板与手输只更新另一端，并保持原有起止顺序；为避免清掉锁定值，此时隐藏整体清空按钮。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
-import { DatePicker } from 'x-next';
+import { DatePicker, RangePicker } from 'x-next';
 import { ref } from 'vue';
 const date = ref('2026-09-30');
+const range = ref(['2026-06-01', '2026-06-30']);
+import type { HTMLAttributes } from 'vue';
+const nativeAttrs1 = { "aria-label": "开始日期已锁定" } satisfies HTMLAttributes;
 </script>
 <template>
 <DatePicker v-model="date" allow-clear />
   <DatePicker default-value="2026-06-04" readonly />
   <DatePicker default-value="2026-06-04" disabled />
   <DatePicker v-model="date" error />
+  <RangePicker v-bind="nativeAttrs1" v-model="range" :disabled="[true, false]"  />
 </template>
 ```
 
@@ -4930,7 +5218,9 @@ const nativeAttrs2 = { "aria-label": "预约日期范围" } satisfies HTMLAttrib
 
 - `showTime` 仅在日期和日期范围模式生效，默认格式为 `YYYY-MM-DD HH:mm:ss`，选择后需要点击“确定”提交。
 - `showLunar` 仅影响日期格辅助展示，不改变 `modelValue`、`format`、范围排序或禁用逻辑；内置数据来自香港天文台 1901-2100 年公历 / 农历对照表，超出范围时默认不展示。
-- 非法手动输入不会提交新值；按 Enter 或失焦时会尝试按 `format` 解析。
+- 合法手输按 Enter 或失焦提交，日期时间保留时分秒。不存在的日期、越界时间或命中禁用规则的输入会恢复已提交值；编辑空草稿期间不立即回填。
+- 今天、快捷项与确认提交同样遵守禁用规则；确认前规则变化导致草稿不可选时，“确定”按钮禁用。日期时间面板点选仍需点击“确定”提交。
+- 面板标题为年月文本，使用左右箭头翻页；当前不提供点击标题进行年月视图下钻。
 - 普通范围选择会在选择结束值后自动排序并提交；开启 `showTime` 后需要点击“确定”提交。
 - `valueFormat="timestamp"` 会让绑定值和事件值返回时间戳。
 
@@ -5244,6 +5534,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
@@ -5477,6 +5799,8 @@ const beforeClose = async (action: 'cancel' | 'ok') => {
 
 ### 显示方式
 
+默认对话框距离顶部 `100px`，可通过 `top` 自定义；设置 `center` 后垂直居中，`fullscreen` 则占满容器。右上角关闭按钮悬停时显示背景，也支持键盘聚焦。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -19730,13 +20054,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
@@ -19752,7 +20075,7 @@ interface BarChartLayout {
 | default | 按钮内容 | () => any |
 | prefix | 前置内容 | () => any |
 | suffix | 后置内容 | () => any |
-| icon | 图标内容，会渲染在文字前；仅有此插槽时按钮等宽高，请设置 aria-label | any |
+| icon | 图标内容，会渲染在文字前；仅有此插槽时通常等宽高，block 时撑满父宽；请设置 aria-label | any |
 
 ### 实例方法
 
@@ -19765,9 +20088,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';
 
@@ -19780,7 +20103,6 @@ type ButtonProps = {
     loadingFill?: boolean;
     debounce?: number;
     shape?: ButtonShape;
-    link?: boolean;
     type?: ButtonTypes;
     htmlType?: ButtonHtmlType;
     status?: ButtonStatus;
@@ -19800,11 +20122,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
 
@@ -19825,9 +20147,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';
 
@@ -19840,7 +20162,6 @@ type ButtonProps = {
     loadingFill?: boolean;
     debounce?: number;
     shape?: ButtonShape;
-    link?: boolean;
     type?: ButtonTypes;
     htmlType?: ButtonHtmlType;
     status?: ButtonStatus;
@@ -20210,7 +20531,7 @@ type GridItemInstance = InstanceType<typeof _GridItem>;
 | pickerValue | 面板显示日期 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 未声明 |
 | defaultPickerValue | 默认面板显示日期 | undefined &#124; string &#124; number &#124; Date &#124; (DatePickerValue &#124; undefined)[] | 否 | 未声明 |
 | placeholder | 占位文案 | undefined &#124; string &#124; string[] | 否 | 未声明 |
-| disabled | 是否禁用 | undefined &#124; false &#124; true &#124; boolean[] | 否 | false |
+| disabled | 是否禁用；范围数组分别锁定两端，单端锁定时只更新另一端并隐藏整体清空 | undefined &#124; false &#124; true &#124; boolean[] | 否 | false |
 | readonly | 是否只读 | undefined &#124; false &#124; true | 否 | false |
 | disabledInput | 禁止输入框键盘输入但允许面板选择 | undefined &#124; false &#124; true | 否 | false |
 | inputReadOnly | 输入框只读，常用于移动端避免软键盘 | undefined &#124; false &#124; true | 否 | false |
@@ -20232,8 +20553,8 @@ type GridItemInstance = InstanceType<typeof _GridItem>;
 | showToday | 是否显示今天 / 本月 / 今年按钮 | undefined &#124; false &#124; true | 否 | true |
 | showConfirmBtn | 是否显示确认按钮 | undefined &#124; false &#124; true | 否 | false |
 | showTime | 是否开启日期时间选择，仅 date / date-range 生效 | undefined &#124; false &#124; true | 否 | false |
-| timePickerProps | 时间列配置，支持 format、step、use12Hours、disabledHours、disabledMinutes、disabledSeconds、hideDisabledOptions、defaultValue | undefined &#124; { [x: string]: any; } | 否 | 未声明 |
-| disabledTime | 禁用时间，需要配合 showTime 使用 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 未声明 |
+| timePickerProps | 时间列配置，支持 format、step、use12Hours、disabledHours、disabledMinutes、disabledSeconds、hideDisabledOptions、defaultValue | undefined &#124; DatePickerTimePickerProps | 否 | 未声明 |
+| disabledTime | 禁用时间，需要配合 showTime 使用 | undefined &#124; (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps &#124; undefined | 否 | 未声明 |
 | showLunar | 是否展示中国农历辅助信息，支持控制农历日期、农历节日、节气和公历节日 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | false |
 
 ### Events
@@ -20264,9 +20585,12 @@ type GridItemInstance = InstanceType<typeof _GridItem>;
 | cell | 自定义日期单元格 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
 | extra | 面板快捷区额外内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | () => void |
+| blur | () => void |
 
 ### 关联类型定义
 
@@ -20469,7 +20793,7 @@ interface DialogCaller {
 | renderTo | 见场景用法与类型 | undefined &#124; string &#124; HTMLElement | 否 | "body" |
 | disabled | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false |
 | modelValue | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false |
-| top | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | "3vh" |
+| top | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | "100px" |
 | center | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | false |
 | width | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | 0 |
 | height | 见场景用法与类型 | undefined &#124; string &#124; number | 否 | 0 |
@@ -20680,8 +21004,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> | 否 | 未声明 |
@@ -20820,6 +21144,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -20854,9 +21179,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
@@ -20929,6 +21254,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -21023,6 +21349,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -21123,6 +21450,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -21229,6 +21557,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -27491,7 +27820,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 | 否 | 透传内层组件；默认值见对应组件 |
@@ -28848,8 +29177,8 @@ interface IMessageItem extends Required<Pick<IMessageOptions, 'duration' | 'posi
 | showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
-| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
-| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; DatePickerTimePickerProps | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
 | showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
 
 ### Events
@@ -28874,9 +29203,12 @@ interface IMessageItem extends Required<Pick<IMessageOptions, 'duration' | 'posi
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -29480,8 +29812,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 | 否 | 未声明 |
@@ -29734,8 +30066,8 @@ type PopconfirmTypes = 'primary' | 'success' | 'warning' | 'strong' | 'danger' |
 | showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
-| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
-| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; DatePickerTimePickerProps | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
 | showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
 
 ### Events
@@ -29760,9 +30092,12 @@ type PopconfirmTypes = 'primary' | 'success' | 'warning' | 'strong' | 'danger' |
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -30075,8 +30410,8 @@ interface RadioGroupContext {
 | showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
-| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
-| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; DatePickerTimePickerProps | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
 | showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
 
 ### Events
@@ -30101,9 +30436,12 @@ interface RadioGroupContext {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -34255,7 +34593,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 转换） |
@@ -34308,7 +34646,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" | 否 | 未声明 |
 
@@ -36302,8 +36640,8 @@ type WatermarkGap = [number, number];
 | showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
-| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
-| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; DatePickerTimePickerProps | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
 | showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
 
 ### Events
@@ -36328,9 +36666,12 @@ type WatermarkGap = [number, number];
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -36485,8 +36826,8 @@ interface DatePickerProps {
 | showToday | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showConfirmBtn | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
 | showTime | 见场景用法与类型 | undefined &#124; false &#124; true | 否 | 透传内层组件；默认值见对应组件 |
-| timePickerProps | 见场景用法与类型 | undefined &#124; { [x: string]: any; } | 否 | 透传内层组件；默认值见对应组件 |
-| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => Record<string, any> &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
+| timePickerProps | 见场景用法与类型 | undefined &#124; DatePickerTimePickerProps | 否 | 透传内层组件；默认值见对应组件 |
+| disabledTime | 见场景用法与类型 | undefined &#124; (current?: Date, type?: DatePickerRange) => DatePickerDisabledTimeProps &#124; undefined | 否 | 透传内层组件；默认值见对应组件 |
 | showLunar | 见场景用法与类型 | undefined &#124; false &#124; true &#124; { showLunarDate?: boolean; showLunarFestival?: boolean; showSolarTerm?: boolean; showSolarFestival?: boolean; fallbackText?: string; } | 否 | 透传内层组件；默认值见对应组件 |
 
 ### Events
@@ -36511,9 +36852,12 @@ interface DatePickerProps {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义