x-next 1.18.0 → 1.18.2

package/AI_USAGE/catalog.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # 公开组件与服务导航
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从当前构建的根公共声明生成，包含 106 个具名组件/服务导出（含子组件和别名，不等于组件族数量），每项均有包内用法与 API 导航。运行时仅从 `x-next` 导入；未列出的 hooks、指令和类型继续查 [公共入口声明](../dist/index.d.ts)。
 

package/AI_USAGE/components/alert-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Alert 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/alert.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Alert AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`Alert`；主要模型：v-model:visible。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./alert-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/bar-chart-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # BarChart 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/bar-chart.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # BarChart AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`BarChart`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./bar-chart-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/boxicons.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Boxicons AI 用法
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。本地组件文档导入的选型和配套资源用法。
 

package/AI_USAGE/components/button-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Button 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/button.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Button AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`Button, ButtonGroup`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./button-api.md)，包含本组件族全部子组件和别名。
 
@@ -397,7 +397,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。
 
 以下为默认主题中的尺寸规格；链接和形状选项会按对应规则调整布局。
 
@@ -406,8 +406,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">

package/AI_USAGE/components/charts.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Charts AI 用法
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。本地组件文档导入的选型和配套资源用法。
 

package/AI_USAGE/components/checkbox-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Checkbox 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/checkbox.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Checkbox AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`Checkbox, CheckboxGroup`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./checkbox-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/color-picker-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ColorPicker 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/color-picker.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ColorPicker AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`ColorPicker`；主要模型：v-model、v-model:show。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./color-picker-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/config-provider-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ConfigProvider 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/config-provider.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # ConfigProvider AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`ConfigProvider`；主要模型：无。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./config-provider-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/date-picker-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # DatePicker 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 
@@ -19,7 +19,7 @@
 | 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 |
@@ -41,8 +41,8 @@
 | 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
@@ -73,9 +73,12 @@
 | cell | 自定义日期单元格 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
 | extra | 面板快捷区额外内容 | 文档列出的实际插槽；公开类型未细化，作用域见场景用法 |
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | () => void |
+| blur | () => void |
 
 ### 关联类型定义
 
@@ -230,8 +233,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
@@ -256,9 +259,12 @@ interface DatePickerProps {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -413,8 +419,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
@@ -439,9 +445,12 @@ interface DatePickerProps {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -597,8 +606,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
@@ -623,9 +632,12 @@ interface DatePickerProps {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -780,8 +792,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
@@ -806,9 +818,12 @@ interface DatePickerProps {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 
@@ -963,8 +978,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
@@ -989,9 +1004,12 @@ interface DatePickerProps {
 
 公开类型未逐项声明插槽；本页场景说明列出实际使用的插槽，不将任意插槽视为已支持。
 
-### 实例方法
+### 实例方法 / 暴露值
 
-没有检索到显式 expose 或 Options API methods 的公开方法；不把 setup 内部函数当成稳定实例 API。
+| 名称 | 公开类型 |
+| --- | --- |
+| focus | (() => void) & (() => void) |
+| blur | (() => void) & (() => void) |
 
 ### 关联类型定义
 

package/AI_USAGE/components/date-picker.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # DatePicker AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`DatePicker, MonthPicker, QuarterPicker, RangePicker, WeekPicker, YearPicker`；主要模型：v-model、v-model:popup-visible。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./date-picker-api.md)，包含本组件族全部子组件和别名。
 
@@ -128,6 +128,10 @@ const range = ref(['2026-06-01', '2026-06-30']);
 
 ### 中国农历展示
 
+### 农历空辅助行和禁用状态
+
+只显示节日和节气时，部分日期没有辅助文案；数字、选中圆圈和范围色带仍共用同一日期区。周末禁用时，数字与农历文字一同弱化，包括绑定值已命中禁用日期的情况。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';
@@ -146,6 +150,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
@@ -163,6 +185,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
@@ -235,18 +302,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>
 ```
 
@@ -400,7 +473,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"` 会让绑定值和事件值返回时间戳。
 

package/AI_USAGE/components/dialog-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dialog 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 
@@ -88,7 +88,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 |

package/AI_USAGE/components/dialog.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dialog AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`Dialog, DialogComponent`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./dialog-api.md)，包含本组件族全部子组件和别名。
 
@@ -11,6 +11,8 @@
 
 [组件文档与 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
@@ -103,6 +105,8 @@ const beforeClose = async (action: 'cancel' | 'ok') => {
 
 ### 显示方式
 
+默认对话框距离顶部 `100px`，可通过 `top` 自定义；设置 `center` 后垂直居中，`fullscreen` 则占满容器。右上角关闭按钮悬停时显示背景，也支持键盘聚焦。
+
 ```vue
 <script setup lang="ts">
 import 'x-next/style.css';

package/AI_USAGE/components/draggable-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Draggable 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/draggable.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Draggable AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`Draggable`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./draggable-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/drawer-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Drawer 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 

package/AI_USAGE/components/drawer.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Drawer AI 使用
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 先读 [通用接入](../core.md)。公开导出：`Drawer`；主要模型：v-model。完整 Props、Events、Slots、实例方法与服务签名见 [本地 API](./drawer-api.md)，包含本组件族全部子组件和别名。
 

package/AI_USAGE/components/dropdown-api.md

@@ -1,7 +1,7 @@
 <!-- Generated by pnpm generate:ai-usage. Edit script/ai-usage/content.md and script/ai-usage/. -->
 # Dropdown 完整公开 API
 
-适用版本：x-next@1.18.0；来源指纹：`a0432ebab3728998205092a9a7e188702b81ff8c0550430bc02ff73b265af282`。
+适用版本：x-next@1.18.2；来源指纹：`4974aabb559b27116f3ec133b2a22af9b77b4b87d576ff30e821018746eebd80`。
 
 从同版本构建的公开声明、运行时 props/emits 和显式 expose 生成。运行时导入始终使用 `x-next`，声明路径仅作定位。插槽类型未细化时，具体槽名与作用域见本地用法示例。
 
@@ -97,6 +97,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -206,6 +207,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -300,6 +302,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -400,6 +403,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }
 
@@ -506,6 +510,7 @@ type DropdownOption = DOption | DGroup | DSubmenu;
 
 interface DropdownContext {
     popupMaxHeight: boolean | number;
+    onTabOut?: () => void;
     onOptionClick: (value: string | number | Record<string, unknown> | undefined, ev: Event) => void;
 }