x-next 1.9.0 → 1.10.1

package/AI_USAGE.md

@@ -1,11 +1,11 @@
 <!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage.md and script/ai-usage/manifest.js. -->
 # x-next AI 使用手册
 
-适用版本：**x-next@1.9.0**。Vue：`^3.5.0`；Node：`>=20.19.0`。
+适用版本：**x-next@1.10.1**。Vue：`^3.5.0`；Node：`>=20.19.0`。
 
-来源指纹（精选示例、映射、版本与公开类型声明）：`151adc8affe9aa22cdd6adad1e92c2091f9d33a67f34de49fb767ec647df2a92`。
+来源指纹（精选示例、映射、版本与公开类型声明）：`c37fbf755e64965a7c5f31201af1884cbf1bf81fedb0a8210ed326b16e14709c`。
 
-本手册覆盖 26 个常用组件与服务；包内还有更多导出可用，只是未在此逐个展开。按业务需要选择即可，不必全部使用。
+本手册覆盖 27 个常用组件与服务；包内还有更多导出可用，只是未在此逐个展开。按业务需要选择即可，不必全部使用。
 
 读取入口：`node_modules/x-next/AI_USAGE.md`；可用 `require.resolve('x-next/AI_USAGE.md')` 定位。这个文件名不会自动让所有 AI 工具加载，消费项目应在自己的指令中明确引用。
 
@@ -13,6 +13,7 @@
 
 | 组件/服务 | 公共导出 | 全局标签/形式 | 受控模型 | 详细文档 |
 | --- | --- | --- | --- | --- |
+| ConfigProvider | `ConfigProvider` | `<x-config-provider>` | 无 | [组件文档](https://x-next.yjmf.com/components/config-provider) |
 | Button | `Button` | `<x-button>` | 无 | [组件文档](https://x-next.yjmf.com/components/button) |
 | Checkbox | `Checkbox` | `<x-checkbox>` | `v-model` | [组件文档](https://x-next.yjmf.com/components/checkbox) |
 | Radio | `Radio` | `<x-radio>` | `v-model` | [组件文档](https://x-next.yjmf.com/components/radio) |
@@ -49,18 +50,17 @@
 npm install x-next
 ```
 
-应用需已有 Vue 3、TypeScript 和 Vue SFC 构建支持。在 `main.ts` 全局安装插件：
+应用需已有 Vue 3、TypeScript 和 Vue SFC 构建支持。按需具名导入无需安装全局插件；在 `main.ts` 引入一次样式：
 
 ```ts
 import { createApp } from 'vue';
-import XNext from 'x-next';
 import App from './App.vue';
 import 'x-next/dist/style.css';
 
-createApp(App).use(XNext).mount('#app');
+createApp(App).mount('#app');
 ```
 
-`app.use(XNext)` 注册全部全局组件；下方各节的局部具名导入也可独立使用。根入口的 `Dialog` 是命令式服务，模板组件是 `DialogComponent`；MessageBox 使用服务函数。
+下方各节使用局部具名导入。需要全局注册时可另用 `app.use(XNext)`（默认导出），它会注册全部组件。根入口的 `Dialog` 是命令式服务，模板组件是 `DialogComponent`；MessageBox 使用服务函数。
 
 接入时遵循这些约定：
 
@@ -71,6 +71,66 @@ createApp(App).use(XNext).mount('#app');
 - **约束业务全局 CSS**：reset 用 `:where(...)` 降低优先级并限定作用域；宽泛的原生元素选择器可能覆盖组件样式。自定义内容用插槽和公开属性，不依赖内部结构类名。
 - **清理页面创建的服务**：保留句柄，在路由页面卸载时调用 `close()`；KeepAlive 页面可在停用时清理。Dialog / MessageBox 的命令式关闭不触发确认、取消回调，业务取消逻辑需自行调用；Message / Notification 的关闭会触发各自的 `onClose`。
 
+## ConfigProvider
+
+局部品牌色用 `themeColor`，它一次生成色阶并重绑定组件别名；不必逐个覆盖 Button、Switch 的颜色。将弹层宿主放在同一主题子树内，Teleport 后仍能继承。Select 默认跟随祖先滚动；要滚动关闭可传 `triggerProps.scrollToClose`。
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Button, ConfigProvider, Select, Switch } from 'x-next';
+
+const brand = ref('#2f6feb');
+const dark = ref(false);
+const value = ref('day');
+const overlayHost = ref<HTMLElement>();
+const switchAttrs = { 'aria-label': '局部暗色' };
+const selectAttrs = { 'aria-label': '统计粒度' };
+const options = [
+  { label: '按天', value: 'day' },
+  { label: '按周', value: 'week' },
+];
+</script>
+
+<template>
+  <ConfigProvider :theme-color="brand" :dark="dark" class="brand-scope">
+    <Button type="primary" @click="brand = brand === '#2f6feb' ? '#0f766e' : '#2f6feb'">
+      切换品牌色
+    </Button>
+    <Switch v-model="dark" v-bind="switchAttrs" />
+    <Select
+      v-if="overlayHost"
+      v-model="value"
+      :options="options"
+      :popup-container="overlayHost"
+      v-bind="selectAttrs"
+      style="width: 160px"
+    />
+    <div ref="overlayHost" class="brand-overlay" />
+  </ConfigProvider>
+</template>
+
+<style scoped>
+.brand-scope {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 12px;
+  padding: 16px;
+  color: var(--x-color-text-primary);
+  background: var(--x-color-bg-surface);
+}
+.brand-overlay {
+  position: fixed;
+  inset: 0;
+  pointer-events: none;
+  z-index: 2000;
+}
+</style>
+```
+
+已有主题容器时，也可调用公开 `applyThemeColor(seed, { target, dark })`；切换暗色后需重新调用。只改后代的几条 semantic CSS 变量不会重算祖先 alias；`:tag="null"` 的 ConfigProvider 没有承载局部主题的 DOM。
+
 ## Button
 
 [组件文档与 live demo](https://x-next.yjmf.com/components/button)。`type` 默认 `'default'`，视觉主按钮用 `'primary'`；`htmlType` 默认 `'button'`，原生提交用 `'submit'`。独立使用时尺寸回退为 `'medium'`，`disabled` / `loading` 默认关闭。
@@ -157,6 +217,8 @@ function changed(value: string | number | boolean, _event: Event) {
 
 `change(value)` 返回新值，`clear(event)` 返回 `Event`；单选清空通常为 `''`，多选为 `[]`，已选禁用项可能保留。`v-model:popup-visible` 控制弹层，`option` / `empty` / `header` / `footer` 等插槽见组件文档。
 
+有值且可清空时，右侧 × 与箭头共用位置，点击 × 不切换面板。`v-model:input-value` 控制搜索输入；远程搜索设置 `filterOption=false`，用 `@search` 请求数据并由业务取消旧请求。对象值用 `valueKey` 标识，`fallbackOption` 处理暂时缺失的候选项。默认触发器 ref 类型为 `SelectInstance`，提供 `focus()` / `blur()`；自定义 `trigger` 插槽将 `onKeydown` 绑定到自己的可聚焦节点。
+
 ```vue
 <script setup lang="ts">
 import { ref } from 'vue';

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.10.1] - 2026-10-06
+
+### 修复
+
+- Button `loadingFill` 的覆盖层样式改为匹配实际结构，加载图标在按钮内居中，不再与内容挤占宽度；保留原尺寸与圆角，加载期间视觉隐藏文字及前后缀，结束后恢复，并补充可交互文档示例和编译样式回归测试。
+- Select 的清空与展开图标共用末尾位置，可清空时始终显示 ×；清空保留面板状态并恢复焦点，不隐藏 Form 反馈。
+- Select 统一拦截禁用 / 加载中的选择和删除，清理过期搜索任务；修复动态字段映射、缺失多选值保留、同键对象兜底更新、异步选项默认激活和分组虚拟化；插槽选项与虚拟配置并用时保留普通列表。
+- 多选选项复选框统一由选项处理点击，不再参与外层 Form 注册或 Tab 顺序；原生输入属性落到真实输入，输入法 Backspace 不误删标签。
+- Select 按实际已选值保留最新远程标签，缺失标签仍可清空且保留禁用项；清理卸载的虚拟行引用，加载期间不引用隐藏活动选项，并补齐 Trigger 滚动关闭配置类型。
+
+### 新增
+
+- Select 公开 `focus()` / `blur()`、明确 `focus` / `blur` 事件，自定义 trigger 提供 `onKeydown`；展开时支持 Home / End 定位首末启用项，补齐 Props 类型与对象值、远程搜索、自定义触发器及图标的可交互文档示例。
+
+## [1.10.0] - 2026-10-05
+
+### 新增
+
+- 公共图标补齐四向箭头、双向翻页、问号帮助、纵向更多与顺时针旋转，共 9 种新图形；图标墙展示 59 种推荐图形，保留旧名称与 22 个兼容别名，搜索旧名可定位推荐名称。
+- 新增 `check:icons` 门禁，检查图标生成结果与源码、文档中的静态名称和导入引用，接入完整检查流程。
+
+### 修复
+
+- 公共线性图标统一描边风格，`strokeWidth` 实际生效；内部图标工厂不再覆盖已经注册的公共图标。减少动效模式下，加载图标的外层旋转与内部圆弧动画均停止。
+- 修复图标墙加载圆环被裁切、默认颜色不随暗色主题切换，以及 Clipboard API 不可用时误报复制成功的问题。
+- Select 默认跟随滚动祖先，仍可通过 `triggerProps.updateAtScroll=false` 关闭；Trigger 的滚动关闭支持局部与嵌套容器，按打开时的位置计算阈值，并在关闭/卸载时清理监听。
+- Select 虚拟列表恢复 `dropdown-scroll` / `dropdown-reach-bottom` 事件，复用 `scrollbar` 配置；搜索过滤复位虚拟窗口，尾部追加保持位置，兼容 Table 滚动节点引用。
+- Button 非加载时不再运行隐藏加载动画，保留加载禁用状态和宽度过渡，尊重减少动画偏好。
+- BarChart、LineChart 的末位标签按实际间距避让，首末标签收边；超长文字省略并保留完整提示，避免窄画布叠字或越界。
+
+### 文档
+
+- 图标页新增别名搜索、推荐名称复制和可交互描边示例。
+- AI 使用手册新增 ConfigProvider 局部品牌色与浮层宿主配方，以具名导入作为默认接入方式。
+- 增加 Select 局部滚动、图表完整日期与窄容器的可交互示例。
+
 ## [1.9.0] - 2026-10-05
 
 ### 新增

package/dist/_utils/chart/scale.d.ts

@@ -50,6 +50,6 @@ export declare const formatPercent: (value: number, total: number, digits?: numb
 export declare const estimateTextWidth: (text: string, fontSize: number) => number;
 /**
  * 类目标签抽稀：按柱间距与标签宽度算出步长，保证相邻标签间留有 gap。
- * 末位标签总是保留（趋势图需要看到最新时间点），与倒数第二个太近时挤掉前一个。
+ * 优先保留末位（最新时间点），空间不足时移除冲突项，包括首位。
  */
 export declare const pickLabelIndices: (count: number, band: number, maxLabelWidth: number, gap?: number) => number[];

package/dist/components/_components/chart/axis-labels.d.ts

@@ -0,0 +1,8 @@
+import { ChartAxisXLabel } from './interface';
+export interface PositionedAxisLabel extends ChartAxisXLabel {
+    width: number;
+    /** 完整文案，仅在省略时提供原生 SVG 提示。 */
+    title?: string;
+}
+/** 收边后再次检查文字区间，优先保留最新类目；单个超长标签省略。 */
+export declare const layoutAxisLabels: (labels: ChartAxisXLabel[], left: number, right: number, gap: number, measure: (text: string) => number) => PositionedAxisLabel[];

package/dist/components/_components/select-view/select-view.d.ts

@@ -40,6 +40,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    clearable: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
     allowCreate: {
         type: BooleanConstructor;
         default: boolean;
@@ -114,6 +118,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    clearable: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
     allowCreate: {
         type: BooleanConstructor;
         default: boolean;
@@ -153,6 +161,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     maxTagCount: number;
     retainInputValue: boolean;
     tagNowrap: boolean;
+    clearable: boolean;
     allowCreate: boolean;
     allowSearch: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/components/form-select/Select.d.ts

@@ -297,15 +297,17 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: boolean;
     };
 }>, () => VNode, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    'update:modelValue': (value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
+    focus: (ev: FocusEvent) => true;
+    blur: (ev: FocusEvent) => true;
+    'update:modelValue': (value: string | undefined | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
     'update:inputValue': (inputValue: string) => true;
     'update:popupVisible': (visible: boolean) => true;
     /**
      * @zh 值发生改变时触发
      * @en Triggered when the value changes
-     * @param { string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] } value
+     * @param { string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined } value
      */
-    change: (value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
+    change: (value: string | undefined | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
     /**
      * @zh 输入框的值发生改变时触发
      * @en Triggered when the value of the input changes
@@ -644,11 +646,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         default: boolean;
     };
 }>> & Readonly<{
+    onFocus?: ((ev: FocusEvent) => any) | undefined;
     onSearch?: ((inputValue: string) => any) | undefined;
     onClear?: ((ev: Event) => any) | undefined;
     onRemove?: ((removed: string | number | boolean | Record<string, any> | undefined) => any) | undefined;
-    onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
+    onBlur?: ((ev: FocusEvent) => any) | undefined;
+    onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
     "onUpdate:popupVisible"?: ((visible: boolean) => any) | undefined;
     onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
     "onUpdate:inputValue"?: ((inputValue: string) => any) | undefined;
@@ -1292,6 +1296,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: BooleanConstructor;
             default: boolean;
         };
+        clearable: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
         allowCreate: {
             type: BooleanConstructor;
             default: boolean;
@@ -1366,6 +1374,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             type: BooleanConstructor;
             default: boolean;
         };
+        clearable: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
         allowCreate: {
             type: BooleanConstructor;
             default: boolean;
@@ -1405,6 +1417,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         maxTagCount: number;
         retainInputValue: boolean;
         tagNowrap: boolean;
+        clearable: boolean;
         allowCreate: boolean;
         allowSearch: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/components/form-select/SelectOptionGroup.vue.d.ts

@@ -13,6 +13,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         modifier: (className: string) => string;
         is: (className: string) => string;
     };
+    component: import('vue').ComputedRef<string>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     /**
      * @zh 选项组的标题

package/dist/components/form-select/hooks/use-options.d.ts

@@ -17,7 +17,7 @@ export declare const useOptions: ({ options, extraOptions, inputValue, filterOpt
         key: string;
         index?: number | undefined;
         origin: "slot" | "options" | "extraOptions";
-        value: import('../interface').SelectOptionValue;
+        value: import('..').SelectOptionValue;
         label: string;
         disabled?: boolean | undefined;
         tagProps?: any;

package/dist/components/form-select/hooks/use-select.d.ts

@@ -32,7 +32,7 @@ export declare const useSelect: ({ multiple, options, extraOptions, inputValue,
         key: string;
         index?: number | undefined;
         origin: "slot" | "options" | "extraOptions";
-        value: import('../interface').SelectOptionValue;
+        value: import('..').SelectOptionValue;
         label: string;
         disabled?: boolean | undefined;
         tagProps?: any;

package/dist/components/form-select/index.d.ts

@@ -1,4 +1,4 @@
-export type { SelectProps } from './interface';
+export type { SelectProps, SelectInstance, SelectOptionData, SelectOptionGroup as SelectOptionGroupData, SelectOptionValue, } from './interface';
 export declare const Select: {
     new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
         multiple: {
@@ -134,11 +134,13 @@ export declare const Select: {
             default: boolean;
         };
     }>> & Readonly<{
+        onFocus?: ((ev: FocusEvent) => any) | undefined;
         onSearch?: ((inputValue: string) => any) | undefined;
         onClear?: ((ev: Event) => any) | undefined;
         onRemove?: ((removed: string | number | boolean | Record<string, any> | undefined) => any) | undefined;
-        onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
-        "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
+        onBlur?: ((ev: FocusEvent) => any) | undefined;
+        onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
         "onUpdate:popupVisible"?: ((visible: boolean) => any) | undefined;
         onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
         "onUpdate:inputValue"?: ((inputValue: string) => any) | undefined;
@@ -147,10 +149,12 @@ export declare const Select: {
         onDropdownReachBottom?: ((ev: Event) => any) | undefined;
         onExceedLimit?: ((value: string | number | boolean | Record<string, any> | undefined, ev: Event) => any) | undefined;
     }>, () => VNode, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        'update:modelValue': (value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
+        focus: (ev: FocusEvent) => true;
+        blur: (ev: FocusEvent) => true;
+        'update:modelValue': (value: string | undefined | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
         'update:inputValue': (inputValue: string) => true;
         'update:popupVisible': (visible: boolean) => true;
-        change: (value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
+        change: (value: string | undefined | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
         inputValueChange: (inputValue: string) => true;
         popupVisibleChange: (visible: boolean) => true;
         clear: (ev: Event) => true;
@@ -795,6 +799,10 @@ export declare const Select: {
                 type: BooleanConstructor;
                 default: boolean;
             };
+            clearable: {
+                type: BooleanConstructor;
+                default: undefined;
+            };
             allowCreate: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -869,6 +877,10 @@ export declare const Select: {
                 type: BooleanConstructor;
                 default: boolean;
             };
+            clearable: {
+                type: BooleanConstructor;
+                default: undefined;
+            };
             allowCreate: {
                 type: BooleanConstructor;
                 default: boolean;
@@ -908,6 +920,7 @@ export declare const Select: {
             maxTagCount: number;
             retainInputValue: boolean;
             tagNowrap: boolean;
+            clearable: boolean;
             allowCreate: boolean;
             allowSearch: boolean;
         }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
@@ -1052,11 +1065,13 @@ export declare const Select: {
             default: boolean;
         };
     }>> & Readonly<{
+        onFocus?: ((ev: FocusEvent) => any) | undefined;
         onSearch?: ((inputValue: string) => any) | undefined;
         onClear?: ((ev: Event) => any) | undefined;
         onRemove?: ((removed: string | number | boolean | Record<string, any> | undefined) => any) | undefined;
-        onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
-        "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
+        onBlur?: ((ev: FocusEvent) => any) | undefined;
+        onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
         "onUpdate:popupVisible"?: ((visible: boolean) => any) | undefined;
         onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
         "onUpdate:inputValue"?: ((inputValue: string) => any) | undefined;
@@ -1232,11 +1247,13 @@ export declare const Select: {
         default: boolean;
     };
 }>> & Readonly<{
+    onFocus?: ((ev: FocusEvent) => any) | undefined;
     onSearch?: ((inputValue: string) => any) | undefined;
     onClear?: ((ev: Event) => any) | undefined;
     onRemove?: ((removed: string | number | boolean | Record<string, any> | undefined) => any) | undefined;
-    onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => any) | undefined;
+    onBlur?: ((ev: FocusEvent) => any) | undefined;
+    onChange?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[] | undefined) => any) | undefined;
     "onUpdate:popupVisible"?: ((visible: boolean) => any) | undefined;
     onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
     "onUpdate:inputValue"?: ((inputValue: string) => any) | undefined;
@@ -1245,10 +1262,12 @@ export declare const Select: {
     onDropdownReachBottom?: ((ev: Event) => any) | undefined;
     onExceedLimit?: ((value: string | number | boolean | Record<string, any> | undefined, ev: Event) => any) | undefined;
 }>, () => VNode, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    'update:modelValue': (value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
+    focus: (ev: FocusEvent) => true;
+    blur: (ev: FocusEvent) => true;
+    'update:modelValue': (value: string | undefined | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
     'update:inputValue': (inputValue: string) => true;
     'update:popupVisible': (visible: boolean) => true;
-    change: (value: string | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
+    change: (value: string | undefined | number | boolean | Record<string, any> | (string | number | boolean | Record<string, any>)[]) => true;
     inputValueChange: (inputValue: string) => true;
     popupVisibleChange: (visible: boolean) => true;
     clear: (ev: Event) => true;
@@ -1893,6 +1912,10 @@ export declare const Select: {
             type: BooleanConstructor;
             default: boolean;
         };
+        clearable: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
         allowCreate: {
             type: BooleanConstructor;
             default: boolean;
@@ -1967,6 +1990,10 @@ export declare const Select: {
             type: BooleanConstructor;
             default: boolean;
         };
+        clearable: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
         allowCreate: {
             type: BooleanConstructor;
             default: boolean;
@@ -2006,6 +2033,7 @@ export declare const Select: {
         maxTagCount: number;
         retainInputValue: boolean;
         tagNowrap: boolean;
+        clearable: boolean;
         allowCreate: boolean;
         allowSearch: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
@@ -3559,6 +3587,7 @@ export declare const SelectOptionGroup: {
             modifier: (className: string) => string;
             is: (className: string) => string;
         };
+        component: import('vue').ComputedRef<string>;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -3577,6 +3606,7 @@ export declare const SelectOptionGroup: {
             modifier: (className: string) => string;
             is: (className: string) => string;
         };
+        component: import('vue').ComputedRef<string>;
     }, {}, {}, {}, {}>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -3592,6 +3622,7 @@ export declare const SelectOptionGroup: {
         modifier: (className: string) => string;
         is: (className: string) => string;
     };
+    component: import('vue').ComputedRef<string>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & {
     install(app: import('vue').App): void;
 };

package/dist/components/form-select/interface.d.ts

@@ -3,6 +3,11 @@ import { FieldString } from '../../_hooks/_types';
 import { Size } from '../../_utils/constant';
 import { VirtualListProps } from '../virtual-list-v2/interface';
 import { TriggerProps } from '../trigger/interface';
+import { ScrollbarProps } from '../scrollbar-v2';
+export interface SelectInstance {
+    focus: () => void;
+    blur: () => void;
+}
 export interface SelectProps {
     options?: (string | number | boolean | SelectOptionData | SelectOptionGroup)[];
     multiple?: boolean;
@@ -25,6 +30,7 @@ export interface SelectProps {
     bordered?: boolean;
     popupVisible?: boolean;
     defaultPopupVisible?: boolean;
+    defaultActiveFirstOption?: boolean;
     unmountOnClose?: boolean;
     filterOption?: boolean | ((inputValue: string, option: SelectOptionData) => boolean);
     virtualListProps?: VirtualListProps;
@@ -38,6 +44,8 @@ export interface SelectProps {
     fieldNames?: SelectFieldNames;
     showHeaderOnEmpty?: boolean;
     showFooterOnEmpty?: boolean;
+    scrollbar?: boolean | ScrollbarProps;
+    tagNowrap?: boolean;
 }
 export type SelectOptionValue = string | number | boolean | Record<string, unknown>;
 export interface OptionValueWithKey {

package/dist/components/link/Link.vue.d.ts

@@ -121,8 +121,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
 }>, {
     strong: boolean;
     disabled: boolean;
-    icon: boolean;
     loading: boolean;
+    icon: boolean;
     status: "normal" | "success" | "warning" | "strong" | "danger";
     hoverable: boolean;
 }, {}, {

package/dist/components/link/index.d.ts

@@ -37,8 +37,8 @@ export declare const Link: {
     }, import('vue').PublicProps, {
         strong: boolean;
         disabled: boolean;
-        icon: boolean;
         loading: boolean;
+        icon: boolean;
         status: "normal" | "success" | "warning" | "strong" | "danger";
         hoverable: boolean;
     }, true, {}, {}, {
@@ -255,8 +255,8 @@ export declare const Link: {
     }, {}, {}, {}, {
         strong: boolean;
         disabled: boolean;
-        icon: boolean;
         loading: boolean;
+        icon: boolean;
         status: "normal" | "success" | "warning" | "strong" | "danger";
         hoverable: boolean;
     }>;
@@ -301,8 +301,8 @@ export declare const Link: {
 }, string, {
     strong: boolean;
     disabled: boolean;
-    icon: boolean;
     loading: boolean;
+    icon: boolean;
     status: "normal" | "success" | "warning" | "strong" | "danger";
     hoverable: boolean;
 }, {}, string, {}, {