x-next 1.0.1 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [1.2.0] - 2026-09-30
+
+### 新增
+
+- **Form 无障碍关联**：自动关联真实控件与标签、帮助、错误、额外说明；支持多控件、组合控件和 `noStyle`，保留显式 ID 与 ARIA 属性。
+- **DatePicker / TimePicker 键盘操作**：日期网格支持方向键、Home / End、翻页与跳过禁用日期；时间列支持活动项导航。打开面板后进入面板，确认或 Esc 后返回对应输入，范围输入保留正常 Tab 行为。
+- **TimeRangeSelector**：新增 `disabled` / `readonly`、Form 禁用与校验联动、`change` / `remove` 事件；支持键盘新建、移动、调整边界和删除，保留双击删除。
+- 扩充 Form 组件族与 Image 文档 live demo、可复制示例、状态反馈及已知限制。
+
+### 修复
+
+- **Image**：修复 `srcList` 与多个子图片共同使用时的注册循环，消除文档打开后的递归更新与卡顿；图片地址和预览权限更新保留注册顺序，支持预览列表与自动收集模式切换。
+- **Image 预览**：补齐 `v-model:preview-visible` 更新事件，修复 SSR hydration 不匹配、初始越界下标和空列表预览；内置 footer 不再遮挡缩略图点击，额外操作按钮仍可交互。
+- **Form**：阻止过期异步校验回写和过期提交，清理、重置、字段切换及卸载后旧结果不再恢复错误；等待期间显示 `validating`，支持返回 Promise 的自定义校验类型。
+- **Form 布局**：修复 inline 字段宽度、空错误信息间距、空标签宽度和包含特殊字符的字段滚动定位。
+- **输入组件**：修复清空与数值变更的校验联动、原生 ID / ARIA 属性分流、InputSearch 的禁用 / 加载语义和 InputPassword 的禁用显隐。
+- **Textarea / InputTag / Radio / Switch / Rate**：修复动态自动高度、禁用标签关闭、原生单选分组、异步切换过期结果和评分键盘 / ARIA 边界。
+- **Dialog**：焦点圈定跳过隐藏及不可交互元素，支持无标题时的显式 ARIA 名称，并完善关闭、卸载和嵌套弹层的焦点恢复。
+- **文档主题**：VitePress 暗色开关同步组件主题，修复暗色示例背景、时间区间轨道和窄屏 Form / API 表格溢出。
+- 发布脚本使用 `release`，避免 `publish` 生命周期脚本自递归。
+
+### 测试
+
+- 增加 Form 异步与无障碍、日期 / 时间键盘、时间区间、Dialog 焦点、输入状态与 Image 组合注册 / SSR hydration 回归测试。
+
+## [1.1.0] - 2026-09-30
+
+### 新增
+
+- **locale 完整覆盖**：完成日期选择器、时间选择器与零散组件的文案迁移，组件内用户可见文案（含 aria-label）全部走 locale。新增 `datePicker`、`timePicker`、`input`、`menu`、`tabs`、`message` 等语言包分区，并补齐 `validateMessages`（表单校验消息 32 条）。
+- 新增 `ConfigProvider` 全局配置组件，支持 locale 注入与空态插槽（`component` 参数标明请求来源）。
+- 新增 `TimeRangeSelector` 组件，用于一天内多时间段的排班/筛选配置。
+- 新增 `_utils` 纯函数与基础设施测试覆盖（18 个模块）。
+- 导出 `useFormItem` 与 `UseFormItemOptions`，支持自定义控件接入 Form 校验。
+
+### 修复
+
+- **Space**：根节点外部 class 被重复输出两次。
+- **Empty**：ConfigProvider 提供 `#empty` 插槽后会静默丢弃组件自身显式配置的 `description` / `imgSrc` / 插槽内容；现仅接管未配置的裸空态（与 Arco 一致）。
+- **Dialog**：对话框已打开时把 `escToClose` 由 false 改为 true，Esc 不生效（补齐运行时监听同步）。
+- **DatePicker / TimePicker**：readonly 状态下仍显示并可点击清空按钮，会派发值变更，破坏只读语义；空值范围选择器也会渲染清空按钮。
+- **DatePicker**：range 类型缺少测试覆盖，本轮补充 60 条用例（含五种 range 模式、hover 预览、多面板联动）。
+- **InputTag**：受控与非受控的 `inputValue` / `defaultInputValue` 初值不回显到输入框。
+- **Input**：存在 `prepend` / `append` 时外部 class 与 style 重复落到 outer 与 wrapper 两层。
+- **TimeRangeSelector**：`stepMinutes` 变化后内部块下标未按比例换算，导致区间时间漂移（如 08:15 变成 04:15）。
+- **Form**：`deepClone` 克隆 `Date` 会丢失时间值（变成当前时间）、克隆 dayjs 实例直接抛错，影响表单初始值快照与重置。
+- **isEqual**：`isEqualObject` 漏比对方多出的键，导致 `{a:1}` 与 `{a:1,b:2}` 被判为相等（继承自 Arco 的缺陷）。
+- **getStyle**：三元与逻辑或优先级书写错误，内联样式优先语义失效。
+- **Volar 类型声明**：生成器会静默丢弃文件名小写的组件，导致 `XMessage` 全局声明消失；同时补齐 `XConfigProvider`。
+
+### 移除
+
+- 删除死代码：`_container/utils.ts`、重复的 `components/_components/render-function/`、`script/gen-component-declaration.old.js`、`_utils/number.ts`、`_utils/pad.ts`，以及 `_utils/helpers.ts` 中 9 个零引用导出。
+
+### 测试
+
+- 单元测试从 1262 例扩展到 1651 例（85 个测试文件），并补齐此前零测试的 `dropdown` / `time-picker` / `time-range-selector` 三个组件。
+- 覆盖率门禁从 30 余个模块扩展到 50+ 模块，实测 statements 87.5% / branches 77.8% / functions 89.1% / lines 87.7%。
+- `check:locale` 的待迁移登记清零：`check-locale.js --strict` 的「本轮范围」与「已登记后续批次」均为 0 findings。
+
+### 已知限制
+
+- 不支持 `prefixCls` 自定义：需重构 `getClassNameMixin`，涉及全部组件，属独立设计任务。
+- 不支持 RTL：缺少逻辑属性与方向上下文等基建，需作为平台级能力独立立项。
+- Progress 不支持 `indeterminate` 不确定态与自定义 `format` 文本（可用 `text` 插槽替代）。
+- Space 不支持 Arco 的 `size` 数组写法与 `wrap`。
+
+[1.2.0]: https://gitee.com/ztes/x-next/releases/tag/v1.2.0
+[1.1.0]: https://github.com/ztes/x-next/releases/tag/v1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XuYu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -63,6 +63,18 @@ app.mount('#app');
 Message.success('保存成功');
 ```
 
+### 可选 Finicon 图标集
+
+Finicon 包含大量金融场景 SVG，不会随根入口自动注册。项目需要使用 `finicon:*` 图标时，在应用入口显式注册一次：
+
+```ts
+import { registerFiniconIcons } from 'x-next';
+
+registerFiniconIcons();
+```
+
+这样未使用 Finicon 的应用可以正常 tree-shaking，不会仅因导入单个基础组件而携带整套金融图标。
+
 ## 样式
 
 使用组件时需要引入样式文件：

package/dist/_hooks/use-form-item.d.ts

@@ -1,16 +1,23 @@
 import { Ref } from 'vue';
 import { FormItemContext } from '../components/form/context';
 import { Size } from '../_utils/constant';
-export declare const useFormItem: ({ size, disabled, error, uninject, }?: {
+export interface UseFormItemOptions {
     size?: Ref<Size | undefined>;
     disabled?: Ref<boolean>;
     error?: Ref<boolean>;
+    /** @internal 跳过 FormItem 上下文注入，用于 FormItem 内部嵌套的同名控件 */
     uninject?: boolean;
-}) => {
+}
+export declare const useFormItem: ({ size, disabled, error, uninject }?: UseFormItemOptions) => {
     formItemCtx: FormItemContext;
     mergedSize: import('vue').ComputedRef<"mini" | "small" | "medium" | "large" | undefined>;
     mergedDisabled: import('vue').ComputedRef<boolean>;
     mergedError: import('vue').ComputedRef<boolean>;
     feedback: Ref<string | undefined, string | undefined>;
-    eventHandlers: Ref<import('../components/form/interface').FormItemEventHandler, import('../components/form/interface').FormItemEventHandler>;
+    eventHandlers: Ref<import('..').FormItemEventHandler, import('..').FormItemEventHandler>;
 };
+/** Bind to the actual input or interactive group, never its decorative wrapper. */
+export declare const useFormItemControl: (context: FormItemContext, getAttrs?: () => Record<string, unknown>, options?: {
+    labelable?: boolean;
+    required?: boolean;
+}) => import('vue').ComputedRef<Record<string, unknown>>;

package/dist/_hooks/use-picker-focus.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+/** Shared keyboard entry and focus return for teleported picker panels. */
+export declare const usePickerFocus: ({ visible, canOpen, setVisible, focusInput, selector, inputContains, }: {
+    visible: Ref<boolean>;
+    canOpen: () => boolean;
+    setVisible: (visible: boolean) => void;
+    focusInput: () => void;
+    selector: string;
+    inputContains: (target: Node | null) => boolean;
+}) => {
+    popupRef: Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    panelId: string;
+    openPanel: (event?: KeyboardEvent) => void;
+    handlePanelKeydown: (event: KeyboardEvent) => void;
+    isInternalFocus: (target: EventTarget | null) => boolean;
+    handlePanelFocusout: (event: FocusEvent, onLeave: (event: FocusEvent) => void) => void;
+};

package/dist/_styles/palette-aliases.d.ts

@@ -0,0 +1 @@
+export declare const PALETTE_ALIASES: Record<string, Record<string, string>>;

package/dist/_utils/helpers.d.ts

@@ -1,12 +1,3 @@
-export declare const getProp: (target: any, path: any, defVal?: any) => any;
-export declare const setProp: (target: any, path: any, value: any) => any;
 export declare const deepClone: (obj: any, set?: any) => any;
-export declare const NOOP: () => void;
 export declare const addUnit: (value: string | number | undefined, unit?: string) => string;
 export declare const upperFirstChar: (text: string) => string | undefined;
-export declare const compose: <T>(...fns: ((...v: T[]) => T)[]) => (...v: T[]) => T;
-export declare const pipe: <T>(...fns: ((...v: T[]) => T)[]) => (...v: T[]) => T;
-export declare const findLastIndex: (arr: never[] | undefined, callback: (item: any, i: number, origin: any[]) => boolean) => number;
-export declare const getUniqueId: (size?: number) => string;
-export declare const genMatrix: (list: any[], row: number) => any[];
-export declare const sleep: (delay?: number) => Promise<unknown>;

package/dist/_utils/palette.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 色阶生成算法。
+ *
+ * 组件库的色阶（primary-1 ~ primary-9 等）由一个种子色派生，而不是逐档手写。
+ * 这样修改主色时全档联动，暗色主题也能复用同一函数。
+ *
+ * 参数由现有 45 个档位反推校准，依据如下（HSL 实测）：
+ *
+ * 1. 明度阶梯以种子色明度为锚点线性插值：
+ *    - 亮端向 L_LIGHT_TARGET 插值，权重 1.0 / 0.8 / 0.6 / 0.4 / 0.2（第 1~5 档）
+ *    - 暗端向 L_DARK_TARGET 插值，权重 1/3 / 2/3 / 1（第 7~9 档）
+ *    以 primary（L=50）验证：预测 96 / 86.8 / 77.6 / 68.4 / 59.2，
+ *    实测 95.5 / 86.5 / 77.3 / 68.2 / 59.0，误差 ≤ 0.2。
+ *
+ * 2. 色相每档漂移约 2.05°。方向按色相区间决定：
+ *    红黄区间（0°~90°）随档位加深而递减，其余区间递增。
+ *    该规则同时命中 primary(+2.2)、success(+2.1)、danger(-2.0)、
+ *    strong(-2.0)、warning(-2.1) 五族的实测方向。
+ *
+ * 3. 饱和度沿用种子色，浅端不做衰减。
+ *    这与 primary / warning / strong 的实测完全一致。
+ */
+export interface PaletteOptions {
+    /**
+     * 生成暗色主题色阶。
+     * 暗色下明度阶梯反转：低档位取更暗的值，高档位取更亮的值。
+     */
+    dark?: boolean;
+}
+export interface HSL {
+    h: number;
+    s: number;
+    l: number;
+}
+/** #rgb / #rrggbb / rgb() / rgba() 转为 RGB 三元组，失败返回 null */
+export declare const parseColor: (input: string) => [number, number, number] | null;
+export declare const rgbToHsl: ([r, g, b]: [number, number, number]) => HSL;
+export declare const hslToRgb: ({ h, s, l }: HSL) => [number, number, number];
+export declare const toHex: (rgb: [number, number, number]) => string;
+/**
+ * 由种子色生成 9 档色阶。
+ *
+ * @param seed 种子色，支持 #rgb / #rrggbb / rgb() / rgba()
+ * @param options.dark 生成暗色主题色阶
+ * @returns 9 个十六进制色值，索引 0 对应第 1 档，索引 5 对应种子色所在的第 6 档
+ *
+ * @example
+ * generatePalette('#0056ff')[5]  // 第 6 档，等于种子色
+ */
+export declare const generatePalette: (seed: string, options?: PaletteOptions) => string[];
+/**
+ * 与色阶同名的派生别名。
+ *
+ * 这些名字在 `:root` 上定义时形如 `--x-color-primary-solid: var(--x-color-primary-6)`，
+ * 而 CSS 自定义属性是在**声明处**解析 `var()` 的：一旦定义在 `:root`，
+ * 其值就固化为 `:root` 当时的色阶，后代元素再覆盖 `-6` 也不会重算。
+ *
+ * 因此写入色阶时必须连带重写这些别名，且要写成 `var(...)` 引用而非解析后的色值，
+ * 让它们在目标元素处重新解析。这样局部主题容器（ConfigProvider）才能生效。
+ */
+/**
+ * 把色阶写入指定元素的 CSS 变量，供运行时换主题色使用。
+ *
+ * 这是"改主色时浅色底不同步变化"问题的正解：一次性写入基色、全部 9 档，
+ * 以及与色阶关联的派生别名（详见 PALETTE_ALIASES 的说明）。
+ *
+ * @param seed 种子色
+ * @param options.name 色名，默认 'primary'（对应 --x-color-primary-N）
+ * @param options.target 写入目标元素，默认 document.documentElement
+ * @param options.dark 是否使用暗色色阶
+ *
+ * @example
+ * import { applyThemeColor } from 'x-next';
+ * applyThemeColor('#0f766e');            // 整条 primary 色阶联动
+ * applyThemeColor('#0f766e', { target: el });  // 仅对某个子树生效
+ */
+export declare const applyThemeColor: (seed: string, options?: PaletteOptions & {
+    name?: string;
+    target?: HTMLElement | null;
+}) => string[];
+/**
+ * 返回指定色名会写入的全部变量名。
+ * 供 ConfigProvider 在换色/卸载时精确清理，避免残留失效变量。
+ */
+export declare const getThemeColorProperties: (name?: string) => string[];

package/dist/components/_components/feedback-icon/index.vue.d.ts

@@ -85,8 +85,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
-        size: string | number;
         title: string;
+        size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
@@ -170,8 +170,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
-        size: string | number;
         title: string;
+        size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
@@ -255,8 +255,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
-        size: string | number;
         title: string;
+        size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
@@ -340,8 +340,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
-        size: string | number;
         title: string;
+        size: string | number;
         rotate: number;
         spin: boolean;
         color: string;

package/dist/components/_components/icon-hover/index.vue.d.ts

@@ -1,6 +1,11 @@
 import { PropType } from 'vue';
 type Size = 'mini' | 'small' | 'medium' | 'large' | 'huge';
+type Tag = 'span' | 'button';
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    as: {
+        type: PropType<Tag>;
+        default: string;
+    };
     prefix: {
         type: StringConstructor;
     };
@@ -21,10 +26,16 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     };
     handleClick: (ev: MouseEvent) => void;
     handleMousedown: (ev: MouseEvent) => void;
+    handleKeydown: (ev: KeyboardEvent) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     click: (ev: MouseEvent) => true;
     mousedown: (ev: MouseEvent) => true;
+    keydown: (ev: KeyboardEvent) => true;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    as: {
+        type: PropType<Tag>;
+        default: string;
+    };
     prefix: {
         type: StringConstructor;
     };
@@ -39,7 +50,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
 }>> & Readonly<{
     onClick?: ((ev: MouseEvent) => any) | undefined;
     onMousedown?: ((ev: MouseEvent) => any) | undefined;
+    onKeydown?: ((ev: KeyboardEvent) => any) | undefined;
 }>, {
+    as: Tag;
     size: Size;
     disabled: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/components/_components/input-label/input-label.d.ts

@@ -17,6 +17,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     error: BooleanConstructor;
     focused: BooleanConstructor;
     uninjectFormItemContext: BooleanConstructor;
+    inputAttrs: PropType<Record<string, unknown>>;
 }>, {
     inputRef: import('vue').Ref<HTMLInputElement | undefined, HTMLInputElement | undefined>;
     render: () => VNode;
@@ -45,10 +46,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     error: BooleanConstructor;
     focused: BooleanConstructor;
     uninjectFormItemContext: BooleanConstructor;
+    inputAttrs: PropType<Record<string, unknown>>;
 }>> & Readonly<{
     onFocus?: ((ev: FocusEvent) => any) | undefined;
-    onBlur?: ((ev: FocusEvent) => any) | undefined;
     onKeydown?: ((ev: KeyboardEvent) => any) | undefined;
+    onBlur?: ((ev: FocusEvent) => any) | undefined;
     "onUpdate:inputValue"?: ((inputValue: string) => any) | undefined;
     onInputValueChange?: ((inputValue: string, ev: Event) => any) | undefined;
 }>, {

package/dist/components/_components/picker/input-range.vue.d.ts

@@ -34,11 +34,24 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<(Dayjs | undefined)[]>;
         default: () => never[];
     };
+    /**
+     * 清空按钮 aria 文案用的 locale key，由父组件按日期/时间语义传入
+     */
+    clearTargetKey: {
+        type: StringConstructor;
+        default: string;
+    };
     format: {
         type: PropType<string | ((value: Dayjs) => string)>;
         required: true;
     };
 }>, {
+    wrapperAttrs: import('vue').ComputedRef<Omit<{
+        [x: string]: unknown;
+    }, string>>;
+    formControlAttrs0: import('vue').ComputedRef<Record<string, unknown>>;
+    formControlAttrs1: import('vue').ComputedRef<Record<string, unknown>>;
+    t: (key: import('../../../locale').LocaleKey | (string & {}), params?: Record<string, string | number>) => string;
     className: {
         block: string;
         element: (className: string) => string;
@@ -64,7 +77,6 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     onFocus: (e: Event) => void;
     onBlur: (e: Event) => void;
     onPressEnter: () => void;
-    onPressTab: (e: Event) => void;
     onClear: (e: Event) => void;
     feedback: import('vue').Ref<string | undefined, string | undefined>;
 }, {}, {}, {
@@ -104,6 +116,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: PropType<(Dayjs | undefined)[]>;
         default: () => never[];
     };
+    /**
+     * 清空按钮 aria 文案用的 locale key，由父组件按日期/时间语义传入
+     */
+    clearTargetKey: {
+        type: StringConstructor;
+        default: string;
+    };
     format: {
         type: PropType<string | ((value: Dayjs) => string)>;
         required: true;
@@ -124,8 +143,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     value: (Dayjs | undefined)[];
     focused: boolean;
     allowClear: boolean;
+    clearTargetKey: string;
 }, {}, {
     IconHover: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        as: {
+            type: PropType<"span" | "button">;
+            default: string;
+        };
         prefix: {
             type: StringConstructor;
         };
@@ -146,10 +170,16 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
         handleClick: (ev: MouseEvent) => void;
         handleMousedown: (ev: MouseEvent) => void;
+        handleKeydown: (ev: KeyboardEvent) => void;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         click: (ev: MouseEvent) => true;
         mousedown: (ev: MouseEvent) => true;
+        keydown: (ev: KeyboardEvent) => true;
     }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        as: {
+            type: PropType<"span" | "button">;
+            default: string;
+        };
         prefix: {
             type: StringConstructor;
         };
@@ -164,7 +194,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     }>> & Readonly<{
         onClick?: ((ev: MouseEvent) => any) | undefined;
         onMousedown?: ((ev: MouseEvent) => any) | undefined;
+        onKeydown?: ((ev: KeyboardEvent) => any) | undefined;
     }>, {
+        as: "span" | "button";
         size: "mini" | "small" | "medium" | "large" | "huge";
         disabled: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
@@ -244,8 +276,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
-        size: string | number;
         title: string;
+        size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
@@ -340,8 +372,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
@@ -425,8 +457,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
@@ -510,8 +542,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
@@ -595,8 +627,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;

package/dist/components/_components/picker/input.vue.d.ts

@@ -28,11 +28,23 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     value: {
         type: PropType<Dayjs>;
     };
+    /**
+     * 清空按钮 aria 文案用的 locale key，由父组件按日期/时间语义传入
+     */
+    clearTargetKey: {
+        type: StringConstructor;
+        default: string;
+    };
     format: {
         type: PropType<string | ((value: Dayjs) => string)>;
         required: true;
     };
 }>, {
+    wrapperAttrs: import('vue').ComputedRef<Omit<{
+        [x: string]: unknown;
+    }, string>>;
+    formControlAttrs: import('vue').ComputedRef<Record<string, unknown>>;
+    t: (key: import('../../../locale').LocaleKey | (string & {}), params?: Record<string, string | number>) => string;
     feedback: import('vue').Ref<string | undefined, string | undefined>;
     className: {
         block: string;
@@ -82,6 +94,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     value: {
         type: PropType<Dayjs>;
     };
+    /**
+     * 清空按钮 aria 文案用的 locale key，由父组件按日期/时间语义传入
+     */
+    clearTargetKey: {
+        type: StringConstructor;
+        default: string;
+    };
     format: {
         type: PropType<string | ((value: Dayjs) => string)>;
         required: true;
@@ -98,8 +117,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     disabled: boolean;
     focused: boolean;
     allowClear: boolean;
+    clearTargetKey: string;
 }, {}, {
     IconHover: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        as: {
+            type: PropType<"span" | "button">;
+            default: string;
+        };
         prefix: {
             type: StringConstructor;
         };
@@ -120,10 +144,16 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
         handleClick: (ev: MouseEvent) => void;
         handleMousedown: (ev: MouseEvent) => void;
+        handleKeydown: (ev: KeyboardEvent) => void;
     }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         click: (ev: MouseEvent) => true;
         mousedown: (ev: MouseEvent) => true;
+        keydown: (ev: KeyboardEvent) => true;
     }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        as: {
+            type: PropType<"span" | "button">;
+            default: string;
+        };
         prefix: {
             type: StringConstructor;
         };
@@ -138,7 +168,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     }>> & Readonly<{
         onClick?: ((ev: MouseEvent) => any) | undefined;
         onMousedown?: ((ev: MouseEvent) => any) | undefined;
+        onKeydown?: ((ev: KeyboardEvent) => any) | undefined;
     }>, {
+        as: "span" | "button";
         size: "mini" | "small" | "medium" | "large" | "huge";
         disabled: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
@@ -218,8 +250,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
-        size: string | number;
         title: string;
+        size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
@@ -314,8 +346,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
@@ -399,8 +431,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
@@ -484,8 +516,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
@@ -569,8 +601,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
-            size: string | number;
             title: string;
+            size: string | number;
             rotate: number;
             spin: boolean;
             color: string;

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

@@ -60,6 +60,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    inputAttrs: PropType<Record<string, unknown>>;
 }>, {
     inputRef: import('vue').ComputedRef<HTMLInputElement>;
     handleFocus: (ev: FocusEvent) => void;
@@ -133,12 +134,13 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         type: BooleanConstructor;
         default: boolean;
     };
+    inputAttrs: PropType<Record<string, unknown>>;
 }>> & Readonly<{
     onFocus?: ((ev: FocusEvent) => any) | undefined;
+    onKeydown?: ((ev: KeyboardEvent) => any) | undefined;
     onClear?: ((ev: MouseEvent) => any) | undefined;
     onRemove?: ((tag: string) => any) | undefined;
     onBlur?: ((ev: FocusEvent) => any) | undefined;
-    onKeydown?: ((ev: KeyboardEvent) => any) | undefined;
     onInputValueChange?: ((inputValue: string, ev: Event) => any) | undefined;
 }>, {
     error: boolean;