x-next 1.6.0 → 1.7.0

package/AI_USAGE.md

@@ -1,11 +1,11 @@
 <!-- Generated by pnpm generate:ai-usage. Edit src/docs/guide/ai-usage-recipes.md and script/ai-usage/manifest.js. -->
 # x-next AI 使用手册
 
-适用版本：**x-next@1.6.0**。Vue：`^3.5.0`；Node：`>=20.19.0`。
+适用版本：**x-next@1.7.0**。Vue：`^3.5.0`；Node：`>=20.19.0`。
 
-来源指纹（精选示例、映射、版本与公开类型声明）：`8b4e92e3477781a27ff136cbc59a1f8508ba69d45a4f5539daeee1de7a5d9570`。
+来源指纹（精选示例、映射、版本与公开类型声明）：`9a84aab8ad9388abbcade590e1a24c7d5049c9ef14d04313edfc96860c34ed86`。
 
-先按业务需要选择组件，不要求全部迁移。本手册限定在用户确认的 22 个组件及必要的同族子组件，未覆盖的导出不表示已完成业务验收。
+先按业务需要选择组件，不要求全部迁移。本手册限定在用户确认的 23 个组件及必要的同族子组件，未覆盖的导出不表示已完成业务验收。
 
 读取入口：`node_modules/x-next/AI_USAGE.md`；可用 `require.resolve('x-next/AI_USAGE.md')` 定位。这个文件名不会自动让所有 AI 工具加载，消费项目应在自己的指令中明确引用。
 
@@ -35,7 +35,8 @@
 | Steps | `Steps` | `<x-steps>` | `v-model:current` | [组件文档](https://x-next.ztes.com/components/steps) |
 | Tabs | `Tabs` | `<x-tabs>` | `v-model:active-key` | [组件文档](https://x-next.ztes.com/components/tabs) |
 | Empty | `Empty` | `<x-empty>` | 无 | [组件文档](https://x-next.ztes.com/components/empty) |
-这是一份给业务开发者和 AI Coding 使用的中文代码手册。以下 22 个入口是本手册选定的常用组件与服务；公开导出还有其他能力，不能据此推断所有导出都具有相同成熟度，也不要求每个项目全部使用。
+| Upload | `Upload` | `<x-upload>` | `v-model:file-list` | [组件文档](https://x-next.ztes.com/components/upload) |
+这是一份给业务开发者和 AI Coding 使用的中文代码手册。以下 23 个入口是本手册选定的常用组件与服务；公开导出还有其他能力，不能据此推断所有导出都具有相同成熟度，也不要求每个项目全部使用。
 
 每节提供一个可复制到 `App.vue` 的独立 Vue SFC，显式从 `x-next` 根入口导入，并包含全量 CSS。实际项目可将重复的 CSS 导入统一移到应用入口。本文是代码配方，不新增 live demo；每节链接的既有组件文档提供可交互示例和完整 API。
 
@@ -645,3 +646,55 @@ function refresh() { refreshed.value = true; }
   </Empty>
 </template>
 ```
+
+## Upload
+
+[组件文档与 live demo](https://x-next.ztes.com/components/upload)。`action` 是上传地址，也可用 `customRequest` 接管请求；两者都没提供时组件不会发起上传。`name` 是 FormData 字段名，默认 `'file'`；`method` 默认 `'post'`，`withCredentials` 默认 `false`。
+
+**接入已有上传方法的推荐写法**：`customRequest` 返回 Promise 时组件自动接管状态，resolve 即成功（结果写入 `file.response`，可用 `responseUrlKey` 提取 url，字符串支持 `data.url` 嵌套路径）、reject 即失败并出现重试入口，无需手动调用 `onSuccess` / `onError`。axios、flyio、fetch 或任何返回 Promise 的方法都适用。返回值是 fetch `Response` 时组件读取响应体；非 2xx 按失败处理，`error.status` 为状态码。需要进度与取消时，把 option 的 `signal`（取消 / 移除 / 卸载时触发）与 `onProgress`（0 ~ 1）透传给底层请求。返回 `{ abort }` 并手动回调的旧写法仍然支持。
+
+列表默认非受控，用 `defaultFileList` 给初值；需要外部驱动时用 `v-model:file-list`，列表项以 `uid` 为稳定标识。`listType` 取 `'text' | 'picture' | 'picture-card'`。`limit` 为数量上限，超出会触发 `exceed`，超出部分不进入列表；`beforeUpload` 返回 `false` 拦截、返回新 `File` 替换，支持 Promise。
+
+`change({ file, fileList })` 覆盖加入、进度、成功、失败和移除；`success` / `error` / `remove` / `progress` 是更细粒度的补充。`autoUpload=false` 时文件先以 `init` 入列，再用组件 `submit()` 上传、`abort()` 取消、`retry()` 重试。图片卡场景可加 `image-preview` 用内置 `ImagePreview` 看图。
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { Upload, type UploadFile } from 'x-next';
+import 'x-next/dist/style.css';
+const fileList = ref<UploadFile[]>([]);
+const status = ref('尚未选择文件');
+// 项目里已封装好的上传方法：返回 Promise 即可，组件自动显示成功与失败
+function uploadAttachment(params: { file: File; orderId: string }) {
+  const form = new FormData();
+  form.append('file', params.file);
+  form.append('orderId', params.orderId);
+  return fetch('/api/upload', { method: 'POST', body: form }).then((response) => {
+    if (!response.ok) throw new Error(`上传失败：${response.status}`);
+    return response.json() as Promise<{ data: { url: string } }>;
+  });
+}
+function changed(info: { file: UploadFile; fileList: UploadFile[] }) {
+  status.value = `${info.file.name}：${info.file.status ?? 'unknown'}`;
+}
+function beforeUpload(file: File) {
+  // 超过 2MB 直接拦截，文件不会进入列表
+  return file.size <= 2 * 1024 * 1024;
+}
+</script>
+<template>
+  <Upload
+    v-model:file-list="fileList"
+    :custom-request="({ file }) => uploadAttachment({ file, orderId: 'SO-20261003' })"
+    response-url-key="data.url"
+    name="file"
+    multiple
+    list-type="picture"
+    accept="image/*"
+    :limit="5"
+    :before-upload="beforeUpload"
+    @change="changed"
+  />
+  <p role="status">{{ status }}</p>
+</template>
+```

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.7.0] - 2026-10-04
+
+### 新增
+
+- **Upload 上传组件**：支持点击选择、拖拽（含文件夹递归读取并保留相对路径）、粘贴上传；文本 / 图片 / 图片卡三种列表形态；`limit` 数量限制与 `exceed`、`beforeUpload` 拦截或替换文件、`beforeRemove` 移除前钩子；`autoUpload=false` 手动上传配合 `submit()` / `abort()` / `retry()`；逐项取消回到待上传态（不同于 Arco 归属 error 的处理）；`updateFile(uid, file)` 原地替换文件；`tip` 提示、操作按钮开关、内置 `ImagePreview` 图片预览；`aria-live` 上传状态播报与操作按钮无障碍名称。
+- **接入已有上传方法（`customRequest` 返回 Promise）**：业务只需 `:custom-request="({ file }) => uploadApi({ file, orderId })"`，组件自动接管状态——resolve 即成功、reject 即失败并出现重试入口，结果写入 `file.response`；axios、flyio、fetch 或任何返回 Promise 的方法均可直接接入，无需手动调用 `onSuccess` / `onError`。返回 `{ abort }` 加手动回调的写法继续兼容。
+- **`UploadRequestOption.signal`**：每次尝试独立的 `AbortSignal`，取消上传、移除文件或组件卸载时触发，可直接透传给 fetch / axios 真正中止网络请求。
+- **fetch `Response` 自动归一化**：`customRequest` 直接返回 `fetch(...)` 时，JSON / text 响应体解析后写入 `file.response`，非 2xx 按失败处理并在 `error.status` 提供状态码；axios / flyio 已解析的响应对象原样透传。
+- **`responseUrlKey` 嵌套路径**：字符串支持 `data.url` 形式的路径提取；函数形态增加第二个参数 `response`。
+- 新增 Upload 中英文语言包（`trigger` / `drag` / `fileUploaded` 等 18 项）；ImagePreview 语言包补 `openLabel` / `loadError` / `loading`。
+- 新增 `_self/upload-icons` 图标（上传云、文件、图片、刷新、下载、删除）。
+
+### 修复
+
+- **Image 加载失败态**：默认错误占位由大红底改为中性色底 + 次级文字，错误占位补齐圆角，不再刺眼。
+- **ImagePreview 工具条**：亮色白底改为深色半透明 + 模糊背景，hover 反馈统一为透明底浅色图标，窄屏工具条可折行不再溢出。
+- **Image 换图与 SSR**：`src` 由 `watchEffect` 直写 DOM 改为声明式绑定带 key 的 `img`，SSR 正确输出地址；源变更重置加载状态，旧图片节点的 load / error 事件不再覆盖新图；`description` 按文档回退给 `alt`。
+- **Image / Preview 键盘可达性**：缩略图可聚焦并用 Enter 打开预览；预览弹层补齐 Tab 圈定与关闭后焦点恢复；快捷键只在顶层预览生效。
+- **ImagePreview 加载失败**：失败时提供可访问的错误占位而非只撤下 spinner；`actionsLayout=[]` 时自定义 actions 独立渲染，不再被一并隐藏。
+- **ImagePreview 动态配置与边界**：`keyboard` / `popupContainer` 动态变更时迁移监听并清理计时器；`defaultScale` / `zoomRate` 非法值与满屏零尺寸兜底，不再产生无效 transform。
+- **ImagePreviewAction**：`attrs` 不再覆盖内部 class、`disabled` 与 aria 属性，自定义样式与禁用语义同时生效。
+- **Image 拖拽 hook**：`use-image-drag` 在节点更换时解绑旧监听，移除 / 换图不再残留移动状态。
+- **ImagePreviewGroup 无障碍**：弹层读屏标签传入真实序号与总数，不再恒为「第 1 张，共 1 张」。
+- **多层预览滚动锁**：预览使用 `useOverflow` 引用计数与容器迁移，关闭上层预览不再提前解锁页面滚动。
+- **Image 外置 footer 高度**：根节点高度由内容撑开，多行说明不再溢出或与下方内容重叠。
+- **ImagePreview SSR**：仅客户端清理 wheel 的 RAF，`docs:build` 不再输出 `cancelAnimationFrame` 报错。
+- **Image 原生事件声明**：`load` / `error` 显式声明并转发，消费者 `strictTemplates` 编译通过。
+
+### 文档与测试
+
+- 新增 `upload.md`（15 个 live demo，覆盖接入已有方法、响应提取、进度与取消、多选限制、拖拽、图片卡、手动上传、校验重试、插槽、禁用粘贴、文件夹、替换文件、Form 联动）与 `volar` 注册；组件索引、侧栏同步。
+- `image.md` 重写扩充：12 个场景全部含 live demo 与完整 SFC，补换图、错误恢复、仅自定义工具条、局部容器、键盘组切换等。
+- Upload 单测 81 项（含 Promise resolve / reject、取消后晚到结果不覆盖、signal 中止、fetch Response 归一化、手动回调优先等 13 项新增回归）；Image 新增 21 项行为断言；全量测试 2136 项。
+- AI 使用手册新增 Upload（23 个公共组件），`ai-usage-recipes.md` 示例改为「接入已有上传方法」并重新生成 `AI_USAGE.md`。
+- `check:bundle-size` 的 Input 预算由 38,000 调整为 39,500：Input 消费者结构性携带整个共享语言包（zh-CN + en-US 合计 11,635 bytes，约占 30%），按组件拆分的方案继续在 `项目审查/2026-10-03-main-共享语言包与Input体积门禁.md` 跟踪。
+
 ## [1.6.0] - 2026-10-02
 
 ### 新增

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

@@ -597,8 +597,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             resize: () => true;
         }, import('vue').PublicProps, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -785,8 +785,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
         }>, () => any, {}, {}, {}, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -973,8 +973,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         resize: () => true;
     }, string, {
         disabled: boolean;
-        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         animationName: string;
         autoFitPosition: boolean;
         popupVisible: boolean;

package/dist/components/date-picker/index.d.ts

@@ -483,8 +483,8 @@ export declare const DatePicker: {
                 resize: () => true;
             }, import('vue').PublicProps, {
                 disabled: boolean;
-                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 animationName: string;
                 autoFitPosition: boolean;
                 popupVisible: boolean;
@@ -671,8 +671,8 @@ export declare const DatePicker: {
                 onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
             }>, () => any, {}, {}, {}, {
                 disabled: boolean;
-                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 animationName: string;
                 autoFitPosition: boolean;
                 popupVisible: boolean;
@@ -859,8 +859,8 @@ export declare const DatePicker: {
             resize: () => true;
         }, string, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -4203,8 +4203,8 @@ export declare const DatePicker: {
             resize: () => true;
         }, import('vue').PublicProps, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -4391,8 +4391,8 @@ export declare const DatePicker: {
             onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
         }>, () => any, {}, {}, {}, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -4579,8 +4579,8 @@ export declare const DatePicker: {
         resize: () => true;
     }, string, {
         disabled: boolean;
-        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         animationName: string;
         autoFitPosition: boolean;
         popupVisible: boolean;

package/dist/components/draggable/Draggable.d.ts

@@ -79,7 +79,7 @@ declare const _default: import('vue').DefineComponent<{
     onSpill?: ((evt: import('sortablejs').SortableEvent) => void) | undefined | undefined;
     swap?: boolean | undefined | undefined;
     swapClass?: string | undefined | undefined;
-}, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("sort" | "filter" | "add" | "remove" | "change" | "end" | "start" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose")[], "sort" | "filter" | "add" | "remove" | "change" | "end" | "start" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose", import('vue').PublicProps, Readonly<{
+}, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("sort" | "filter" | "add" | "remove" | "change" | "start" | "end" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose")[], "sort" | "filter" | "add" | "remove" | "change" | "start" | "end" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose", import('vue').PublicProps, Readonly<{
     [x: string]: /*elided*/ any;
     modelValue: any[];
     tag?: string | undefined;

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

@@ -92,7 +92,7 @@ export declare const Draggable: {
         onSort?: ((...args: any[]) => any) | undefined;
         onFilter?: ((...args: any[]) => any) | undefined;
         onMove?: ((...args: any[]) => any) | undefined;
-    }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("sort" | "filter" | "add" | "remove" | "change" | "end" | "start" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose")[], import('vue').PublicProps, {} | {
+    }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("sort" | "filter" | "add" | "remove" | "change" | "start" | "end" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose")[], import('vue').PublicProps, {} | {
         [x: string]: any;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
@@ -293,7 +293,7 @@ export declare const Draggable: {
     onSort?: ((...args: any[]) => any) | undefined;
     onFilter?: ((...args: any[]) => any) | undefined;
     onMove?: ((...args: any[]) => any) | undefined;
-}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("sort" | "filter" | "add" | "remove" | "change" | "end" | "start" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose")[], "sort" | "filter" | "add" | "remove" | "change" | "end" | "start" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose", {} | {
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("sort" | "filter" | "add" | "remove" | "change" | "start" | "end" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose")[], "sort" | "filter" | "add" | "remove" | "change" | "start" | "end" | "clone" | "move" | "update:modelValue" | "update" | "choose" | "unchoose", {} | {
     [x: string]: any;
 }, {}, 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/drawer/index.d.ts

@@ -409,7 +409,7 @@ export declare const Drawer: {
                 fill: boolean;
                 block: boolean;
                 direction: "horizontal" | "vertical";
-                align: "center" | "space-between" | "end" | "start" | "baseline";
+                align: "center" | "start" | "space-between" | "end" | "baseline";
             }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
                 P: {};
                 B: {};
@@ -443,7 +443,7 @@ export declare const Drawer: {
                 fill: boolean;
                 block: boolean;
                 direction: "horizontal" | "vertical";
-                align: "center" | "space-between" | "end" | "start" | "baseline";
+                align: "center" | "start" | "space-between" | "end" | "baseline";
             }>;
             __isFragment?: never;
             __isTeleport?: never;
@@ -474,7 +474,7 @@ export declare const Drawer: {
             fill: boolean;
             block: boolean;
             direction: "horizontal" | "vertical";
-            align: "center" | "space-between" | "end" | "start" | "baseline";
+            align: "center" | "start" | "space-between" | "end" | "baseline";
         }, {}, 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;
         };
@@ -1370,7 +1370,7 @@ export declare const Drawer: {
             fill: boolean;
             block: boolean;
             direction: "horizontal" | "vertical";
-            align: "center" | "space-between" | "end" | "start" | "baseline";
+            align: "center" | "start" | "space-between" | "end" | "baseline";
         }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
             P: {};
             B: {};
@@ -1404,7 +1404,7 @@ export declare const Drawer: {
             fill: boolean;
             block: boolean;
             direction: "horizontal" | "vertical";
-            align: "center" | "space-between" | "end" | "start" | "baseline";
+            align: "center" | "start" | "space-between" | "end" | "baseline";
         }>;
         __isFragment?: never;
         __isTeleport?: never;
@@ -1435,7 +1435,7 @@ export declare const Drawer: {
         fill: boolean;
         block: boolean;
         direction: "horizontal" | "vertical";
-        align: "center" | "space-between" | "end" | "start" | "baseline";
+        align: "center" | "start" | "space-between" | "end" | "baseline";
     }, {}, 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/drawer/src/Drawer.vue.d.ts

@@ -503,7 +503,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             fill: boolean;
             block: boolean;
             direction: "horizontal" | "vertical";
-            align: "center" | "space-between" | "end" | "start" | "baseline";
+            align: "center" | "start" | "space-between" | "end" | "baseline";
         }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
             P: {};
             B: {};
@@ -537,7 +537,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             fill: boolean;
             block: boolean;
             direction: "horizontal" | "vertical";
-            align: "center" | "space-between" | "end" | "start" | "baseline";
+            align: "center" | "start" | "space-between" | "end" | "baseline";
         }>;
         __isFragment?: never;
         __isTeleport?: never;
@@ -568,7 +568,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         fill: boolean;
         block: boolean;
         direction: "horizontal" | "vertical";
-        align: "center" | "space-between" | "end" | "start" | "baseline";
+        align: "center" | "start" | "space-between" | "end" | "baseline";
     }, {}, 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/dropdown/Dropdown.vue.d.ts

@@ -232,8 +232,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     onReachBottom?: ((ev: Event) => any) | undefined;
 }>, {
     loading: boolean;
-    position: DropdownPosition;
     trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+    position: DropdownPosition;
     popupVisible: boolean;
     defaultPopupVisible: boolean;
     alignPoint: boolean;
@@ -400,8 +400,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             resize: () => true;
         }, import('vue').PublicProps, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -588,8 +588,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
         }>, () => any, {}, {}, {}, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -776,8 +776,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         resize: () => true;
     }, string, {
         disabled: boolean;
-        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         animationName: string;
         autoFitPosition: boolean;
         popupVisible: boolean;

package/dist/components/dropdown/DropdownButton.vue.d.ts

@@ -209,8 +209,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     type: ButtonTypes;
     size: ButtonSize;
     disabled: boolean;
-    position: DropdownPosition;
     trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+    position: DropdownPosition;
     popupVisible: boolean;
     defaultPopupVisible: boolean;
     hideOnSelect: boolean;
@@ -745,8 +745,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         onReachBottom?: ((ev: Event) => any) | undefined;
     }>, {
         loading: boolean;
-        position: import('./interface.ts').DropdownPosition;
         trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+        position: import('./interface.ts').DropdownPosition;
         popupVisible: boolean;
         defaultPopupVisible: boolean;
         alignPoint: boolean;
@@ -913,8 +913,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
                 resize: () => true;
             }, import('vue').PublicProps, {
                 disabled: boolean;
-                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 animationName: string;
                 autoFitPosition: boolean;
                 popupVisible: boolean;
@@ -1101,8 +1101,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
                 onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
             }>, () => any, {}, {}, {}, {
                 disabled: boolean;
-                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+                position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
                 animationName: string;
                 autoFitPosition: boolean;
                 popupVisible: boolean;
@@ -1289,8 +1289,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             resize: () => true;
         }, string, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;

package/dist/components/dropdown/DropdownSubmenu.vue.d.ts

@@ -294,8 +294,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
 }>, {
     disabled: boolean;
-    position: "lt" | "rt";
     trigger: "hover" | "click" | ("hover" | "click")[];
+    position: "lt" | "rt";
     popupVisible: boolean;
     defaultPopupVisible: boolean;
 }, {}, {
@@ -457,8 +457,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             resize: () => true;
         }, import('vue').PublicProps, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -645,8 +645,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
             onPopupVisibleChange?: ((visible: boolean) => any) | undefined;
         }>, () => any, {}, {}, {}, {
             disabled: boolean;
-            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+            position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
             animationName: string;
             autoFitPosition: boolean;
             popupVisible: boolean;
@@ -833,8 +833,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         resize: () => true;
     }, string, {
         disabled: boolean;
-        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         trigger: "hover" | "click" | "focus" | "contextMenu" | ("hover" | "click" | "focus" | "contextMenu")[];
+        position: "top" | "tl" | "tr" | "bottom" | "bl" | "br" | "left" | "lt" | "lb" | "right" | "rt" | "rb";
         animationName: string;
         autoFitPosition: boolean;
         popupVisible: boolean;