x-next 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.3.0] - 2026-09-30
+
+### 修复
+
+- **Select**：关闭状态不再吞掉 Escape；方向键可打开下拉，键盘选择与关闭后保留焦点，Tab 保留浏览器原生焦点移动。
+- **Checkbox**：原生 `required`、`form`、`tabindex`、`autofocus` 和 `autocomplete` 属性传到内部 input，保留外层 class/style 与组件受控状态。
+- **Dialog / Drawer**：完善顺序 Tab 候选与共享滚动锁清理，正确归还自定义容器的原始样式。
+- **Dropdown**：补齐受控菜单焦点、方向键/Home/End 导航、禁用项跳过、多级菜单进入返回与 Escape 关闭；保留鼠标点击和悬浮行为。
+- **局部暗色主题**：生成完整受影响变量依赖链，让同一暗色容器内的语义覆盖正确传递到表单和组件别名，保留组件自身覆盖。
+- **文档与类型**：补充 `MessageBoxStaticMethod` 根入口类型导出；快速开始明确局部导入与全局注册的区别。
+
+## [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
 
 ### 新增
@@ -44,4 +80,6 @@
 - Progress 不支持 `indeterminate` 不确定态与自定义 `format` 文本（可用 `text` 插槽替代）。
 - Space 不支持 Arco 的 `size` 数组写法与 `wrap`。
 
+[1.3.0]: https://gitee.com/ztes/x-next/releases/tag/v1.3.0
+[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/dist/_hooks/use-form-item.d.ts

@@ -16,3 +16,8 @@ export declare const useFormItem: ({ size, disabled, error, uninject }?: UseForm
     feedback: Ref<string | undefined, string | undefined>;
     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/components/_components/feedback-icon/index.vue.d.ts

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

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

@@ -46,6 +46,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         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;
@@ -72,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>;
 }, {}, {}, {
@@ -272,11 +276,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -368,11 +372,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -453,11 +457,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -538,11 +542,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -623,11 +627,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];

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

@@ -40,6 +40,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         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: {
@@ -246,11 +250,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -342,11 +346,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -427,11 +431,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -512,11 +516,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -597,11 +601,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];

package/dist/components/alert/Alert.vue.d.ts

@@ -309,11 +309,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -394,11 +394,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -479,11 +479,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -564,11 +564,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -649,11 +649,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];

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

@@ -200,11 +200,11 @@ export declare const Alert: {
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -285,11 +285,11 @@ export declare const Alert: {
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -370,11 +370,11 @@ export declare const Alert: {
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -455,11 +455,11 @@ export declare const Alert: {
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -540,11 +540,11 @@ export declare const Alert: {
             };
         }>> & Readonly<{}>, {
             name: string;
+            title: string;
             size: string | number;
             rotate: number;
             spin: boolean;
             color: string;
-            title: string;
             ariaLabel: string;
             strokeWidth: string | number;
             fillColor: unknown[];
@@ -821,11 +821,11 @@ export declare const Alert: {
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -906,11 +906,11 @@ export declare const Alert: {
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -991,11 +991,11 @@ export declare const Alert: {
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -1076,11 +1076,11 @@ export declare const Alert: {
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];
@@ -1161,11 +1161,11 @@ export declare const Alert: {
         };
     }>> & Readonly<{}>, {
         name: string;
+        title: string;
         size: string | number;
         rotate: number;
         spin: boolean;
         color: string;
-        title: string;
         ariaLabel: string;
         strokeWidth: string | number;
         fillColor: unknown[];

package/dist/components/date-picker/DatePanel.vue.d.ts

@@ -65,6 +65,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         is: (className: string) => string;
     };
     cells: import('vue').ComputedRef<DatePickerCell[]>;
+    cellRows: import('vue').ComputedRef<DatePickerCell[][]>;
+    panelRef: import('vue').Ref<HTMLElement | undefined, HTMLElement | undefined>;
+    activeTitle: import('vue').Ref<string, string>;
+    activeCell: import('vue').ComputedRef<DatePickerCell>;
+    handleCellKeydown: (event: KeyboardEvent, cell: DatePickerCell) => void;
     headerLabel: import('vue').ComputedRef<string>;
     todayLabel: import('vue').ComputedRef<string>;
     weekdayLabels: import('vue').ComputedRef<string[]>;