@mingto/mt-ui 1.1.36 → 1.1.39

package/README.md

@@ -1,19 +1,173 @@
-# 介绍
-
-## 安装
-
-```bash
-pnpm install @mingto/mt-ui --save
-```
-
-## 引入
-
-```ts
-import MtUi from '@mingto/mt-ui'
-import { createApp } from 'vue'
-
-import App from './App.vue'
-import '@mingto/mt-ui/dist/style.css'
-
-createApp(App).use(MtUi).mount('#app')
-```
+# @mingto/mt-ui
+
+基于 Vue 3 的企业级 UI 组件库，提供丰富的业务组件，帮助快速构建现代化应用界面。
+
+## 特性
+
+- 🎨 **设计优雅**：简洁现代的视觉风格
+- 📦 **开箱即用**：无需复杂配置，直接引入使用
+- 🔧 **按需加载**：支持组件按需引入，优化打包体积
+- 🎯 **类型安全**：完整的 TypeScript 类型定义
+- 🌏 **国际化**：内置多语言支持
+
+## 安装
+
+```bash
+pnpm add @mingto/mt-ui
+```
+
+## 快速开始
+
+### 全量引入
+
+```typescript
+import MtUi from '@mingto/mt-ui'
+import { createApp } from 'vue'
+import App from './App.vue'
+import '@mingto/mt-ui/dist/style.css'
+
+const app = createApp(App)
+app.use(MtUi)
+app.mount('#app')
+```
+
+### 按需引入
+
+```typescript
+import { MtButton, MtDialog, MtMessage } from '@mingto/mt-ui'
+import { createApp } from 'vue'
+import App from './App.vue'
+import '@mingto/mt-ui/dist/style.css'
+
+const app = createApp(App)
+app.use(MtButton)
+app.use(MtDialog)
+app.use(MtMessage)
+app.mount('#app')
+```
+
+## 基础组件
+
+| 组件      | 说明     |
+| --------- | -------- |
+| MtButton  | 按钮     |
+| MtIcon    | 图标     |
+| MtImage   | 图片     |
+| MtLoading | 加载     |
+| MtBadge   | 徽标     |
+| MtBacktop | 回到顶部 |
+
+## 表单组件
+
+| 组件       | 说明     |
+| ---------- | -------- |
+| MtUpload   | 文件上传 |
+| MtProgress | 进度条   |
+
+## 展示组件
+
+| 组件          | 说明     |
+| ------------- | -------- |
+| MtAvatarImage | 图片头像 |
+| MtAvatarText  | 文字头像 |
+| MtEmpty       | 空状态   |
+| MtTag         | 标签     |
+| MtQrcode      | 二维码   |
+| MtTable       | 表格     |
+| MtTableColumn | 表格列   |
+| MtPopover     | 气泡卡片 |
+| MtTooltip     | 文字提示 |
+| MtFilePreview | 文件预览 |
+
+## 导航组件
+
+| 组件             | 说明     |
+| ---------------- | -------- |
+| MtTabs           | 标签页   |
+| MtTab            | 标签     |
+| MtInfiniteScroll | 无限滚动 |
+
+## 反馈组件
+
+| 组件      | 说明     |
+| --------- | -------- |
+| MtDialog  | 对话框   |
+| MtMessage | 消息提示 |
+| MtOverlay | 遮罩层   |
+| MtPoster  | 海报     |
+
+## 布局组件
+
+| 组件                 | 说明         |
+| -------------------- | ------------ |
+| MtCell               | 单元格       |
+| MtCellGroup          | 单元格组     |
+| MtButtonGroup        | 按钮组       |
+| MtCollapseTransition | 折叠过渡     |
+| MtFadeTransition     | 淡入淡出过渡 |
+| MtTeleport           | 传送门       |
+| MtConfigProvider     | 全局配置     |
+
+## 使用示例
+
+### 按钮
+
+```vue
+<mt-button type="primary">
+主要按钮
+</mt-button>
+
+<mt-button type="success">
+成功按钮
+</mt-button>
+
+<mt-button type="danger">
+危险按钮
+</mt-button>
+```
+
+### 对话框
+
+```vue
+<mt-dialog v-model="visible" title="标题">
+  <p>对话框内容</p>
+  <template #footer>
+    <mt-button @click="visible = false">取消</mt-button>
+    <mt-button type="primary" @click="visible = false">确定</mt-button>
+  </template>
+</mt-dialog>
+```
+
+### 消息提示
+
+```typescript
+import { MtMessage } from '@mingto/mt-ui'
+
+MtMessage.success('操作成功')
+MtMessage.error('操作失败')
+MtMessage.warning('警告提示')
+```
+
+### 文件上传
+
+```vue
+<mt-upload v-model="fileList" :limit="9">
+  <mt-button type="primary">点击上传</mt-button>
+</mt-upload>
+```
+
+## 全局配置
+
+```vue
+<mt-config-provider :locale="{ lang: 'en' }">
+  <app />
+</mt-config-provider>
+```
+
+## 完整文档
+
+更多组件和详细用法请参考 [官方文档](https://mingto.github.io/mt-utils/ui/)
+
+## 许可证
+
+MIT

package/dist/avatar-image/index.d.ts

@@ -22,7 +22,7 @@ export declare const MtAvatarImage: {
         size: number;
         src: string;
         shape: "circle" | "square";
-        effect: "dark" | "light" | "plain";
+        effect: "plain" | "dark" | "light";
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLDivElement, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -53,7 +53,7 @@ export declare const MtAvatarImage: {
         size: number;
         src: string;
         shape: "circle" | "square";
-        effect: "dark" | "light" | "plain";
+        effect: "plain" | "dark" | "light";
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -81,6 +81,6 @@ export declare const MtAvatarImage: {
     size: number;
     src: string;
     shape: "circle" | "square";
-    effect: "dark" | "light" | "plain";
+    effect: "plain" | "dark" | "light";
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & import('vue').Plugin;
 export default MtAvatarImage;

package/dist/avatar-image/src/avatar-image.vue.d.ts

@@ -40,6 +40,6 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     size: number;
     src: string;
     shape: "circle" | "square";
-    effect: "dark" | "light" | "plain";
+    effect: "plain" | "dark" | "light";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
 export default _default;

package/dist/avatar-text/index.d.ts

@@ -84,9 +84,9 @@ export declare const MtAvatarText: {
     effect: "dark" | "light";
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: Readonly<{
-        default: any;
+        default?: () => import('vue').VNode[];
     }> & {
-        default: any;
+        default?: () => import('vue').VNode[];
     };
 }) & import('vue').Plugin;
 export default MtAvatarText;

package/dist/avatar-text/src/avatar-text.vue.d.ts

@@ -1,9 +1,10 @@
+import { VNode } from 'vue';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
-        default: any;
+        default?: () => VNode[];
     }> & {
-        default: any;
+        default?: () => VNode[];
     };
     refs: {};
     rootEl: HTMLDivElement;

package/dist/backtop/index.d.ts

@@ -22,7 +22,7 @@ export declare const MtBacktop: {
     }>> & Readonly<{
         onClick?: ((event: MouseEvent) => any) | undefined;
     }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-        click: (event: MouseEvent) => void;
+        click: (event: MouseEvent) => any;
     }, import('vue').PublicProps, {
         readonly bottom: string | number;
         readonly right: string | number;
@@ -89,7 +89,7 @@ export declare const MtBacktop: {
 }>> & Readonly<{
     onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    click: (event: MouseEvent) => void;
+    click: (event: MouseEvent) => any;
 }, string, {
     readonly bottom: string | number;
     readonly right: string | number;

package/dist/backtop/src/backtop.d.ts

@@ -36,7 +36,7 @@ declare const backtopEmits: {
     /**
      * 点击按钮触发的事件
      */
-    click: (event: MouseEvent) => boolean;
+    click: (_event: MouseEvent) => void;
 };
 export type BacktopProps = ExtractPropTypes<typeof backtopProps>;
 export type BacktopEmits = typeof backtopEmits;

package/dist/backtop/src/backtop.vue.d.ts

@@ -28,7 +28,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly default: 60;
     };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    click: (event: MouseEvent) => void;
+    click: (event: MouseEvent) => any;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     readonly visibilityHeight: {
         readonly type: import('vue').PropType<number | string>;

package/dist/badge/index.d.ts

@@ -26,10 +26,10 @@ export declare const MtBadge: {
             readonly default: true;
         };
     }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
-        readonly value: string | number;
         readonly visible: boolean;
         readonly dot: boolean;
         readonly offset: [number, number];
+        readonly value: string | number;
         readonly max: number;
         readonly zero: boolean;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLDivElement, import('vue').ComponentProvideOptions, {
@@ -66,10 +66,10 @@ export declare const MtBadge: {
             readonly default: true;
         };
     }>> & Readonly<{}>, {}, {}, {}, {}, {
-        readonly value: string | number;
         readonly visible: boolean;
         readonly dot: boolean;
         readonly offset: [number, number];
+        readonly value: string | number;
         readonly max: number;
         readonly zero: boolean;
     }>;
@@ -103,10 +103,10 @@ export declare const MtBadge: {
         readonly default: true;
     };
 }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
-    readonly value: string | number;
     readonly visible: boolean;
     readonly dot: boolean;
     readonly offset: [number, number];
+    readonly value: string | number;
     readonly max: number;
     readonly zero: boolean;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {

package/dist/badge/src/badge.vue.d.ts

@@ -60,10 +60,10 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly default: true;
     };
 }>> & Readonly<{}>, {
-    readonly value: string | number;
     readonly visible: boolean;
     readonly dot: boolean;
     readonly offset: [number, number];
+    readonly value: string | number;
     readonly max: number;
     readonly zero: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;

package/dist/button/index.d.ts

@@ -54,22 +54,28 @@ export declare const MtButton: {
         };
     }>> & Readonly<{
         onClick?: ((args_0: MouseEvent) => any) | undefined;
-    }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    }>, {
+        ref: import('vue').Ref<HTMLButtonElement | undefined, HTMLButtonElement | undefined>;
+        focus: () => void | undefined;
+        blur: () => void | undefined;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         click: (args_0: MouseEvent) => any;
     }, import('vue').PublicProps, {
         readonly round: boolean;
         readonly size: "normal" | "small" | "large";
-        readonly type: "default" | "error" | "primary" | "success" | "noble";
+        readonly width: string | number;
+        readonly type: "default" | "primary" | "error" | "success" | "noble";
         readonly circle: boolean;
         readonly text: boolean;
-        readonly width: string | number;
-        readonly height: string | number;
-        readonly plain: boolean;
-        readonly loading: boolean;
         readonly disabled: boolean;
+        readonly loading: boolean;
+        readonly height: string | number;
         readonly block: boolean;
-        readonly nativeType: "button" | "reset" | "submit";
-    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLButtonElement, import('vue').ComponentProvideOptions, {
+        readonly plain: boolean;
+        readonly nativeType: "button" | "submit" | "reset";
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        buttonRef: HTMLButtonElement;
+    }, HTMLButtonElement, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
         D: {};
@@ -131,19 +137,23 @@ export declare const MtButton: {
         };
     }>> & Readonly<{
         onClick?: ((args_0: MouseEvent) => any) | undefined;
-    }>, {}, {}, {}, {}, {
+    }>, {
+        ref: import('vue').Ref<HTMLButtonElement | undefined, HTMLButtonElement | undefined>;
+        focus: () => void | undefined;
+        blur: () => void | undefined;
+    }, {}, {}, {}, {
         readonly round: boolean;
         readonly size: "normal" | "small" | "large";
-        readonly type: "default" | "error" | "primary" | "success" | "noble";
+        readonly width: string | number;
+        readonly type: "default" | "primary" | "error" | "success" | "noble";
         readonly circle: boolean;
         readonly text: boolean;
-        readonly width: string | number;
-        readonly height: string | number;
-        readonly plain: boolean;
-        readonly loading: boolean;
         readonly disabled: boolean;
+        readonly loading: boolean;
+        readonly height: string | number;
         readonly block: boolean;
-        readonly nativeType: "button" | "reset" | "submit";
+        readonly plain: boolean;
+        readonly nativeType: "button" | "submit" | "reset";
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -203,28 +213,36 @@ export declare const MtButton: {
     };
 }>> & Readonly<{
     onClick?: ((args_0: MouseEvent) => any) | undefined;
-}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+}>, {
+    ref: import('vue').Ref<HTMLButtonElement | undefined, HTMLButtonElement | undefined>;
+    focus: () => void | undefined;
+    blur: () => void | undefined;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     click: (args_0: MouseEvent) => any;
 }, string, {
     readonly round: boolean;
     readonly size: "normal" | "small" | "large";
-    readonly type: "default" | "error" | "primary" | "success" | "noble";
+    readonly width: string | number;
+    readonly type: "default" | "primary" | "error" | "success" | "noble";
     readonly circle: boolean;
     readonly text: boolean;
-    readonly width: string | number;
-    readonly height: string | number;
-    readonly plain: boolean;
-    readonly loading: boolean;
     readonly disabled: boolean;
+    readonly loading: boolean;
+    readonly height: string | number;
     readonly block: boolean;
-    readonly nativeType: "button" | "reset" | "submit";
+    readonly plain: boolean;
+    readonly nativeType: "button" | "submit" | "reset";
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: Readonly<{
-        default: any;
-        icon: any;
+        default: (scope?: {
+            class?: string;
+        }) => unknown;
+        icon: () => unknown;
     }> & {
-        default: any;
-        icon: any;
+        default: (scope?: {
+            class?: string;
+        }) => unknown;
+        icon: () => unknown;
     };
 }) & import('vue').Plugin;
 export default MtButton;

package/dist/button/src/button.vue.d.ts

@@ -1,13 +1,19 @@
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<{
-        default: any;
-        icon: any;
+        default: (scope?: {
+            class?: string;
+        }) => unknown;
+        icon: () => unknown;
     }> & {
-        default: any;
-        icon: any;
+        default: (scope?: {
+            class?: string;
+        }) => unknown;
+        icon: () => unknown;
+    };
+    refs: {
+        buttonRef: HTMLButtonElement;
     };
-    refs: {};
     rootEl: HTMLButtonElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
@@ -64,7 +70,11 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         readonly type: import('vue').PropType<"button" | "submit" | "reset">;
         readonly default: "button";
     };
-}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+}>, {
+    ref: import('vue').Ref<HTMLButtonElement | undefined, HTMLButtonElement | undefined>;
+    focus: () => void | undefined;
+    blur: () => void | undefined;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     click: (args_0: MouseEvent) => any;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     readonly type: {
@@ -124,17 +134,19 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
 }>, {
     readonly round: boolean;
     readonly size: "normal" | "small" | "large";
-    readonly type: "default" | "error" | "primary" | "success" | "noble";
+    readonly width: string | number;
+    readonly type: "default" | "primary" | "error" | "success" | "noble";
     readonly circle: boolean;
     readonly text: boolean;
-    readonly width: string | number;
-    readonly height: string | number;
-    readonly plain: boolean;
-    readonly loading: boolean;
     readonly disabled: boolean;
+    readonly loading: boolean;
+    readonly height: string | number;
     readonly block: boolean;
-    readonly nativeType: "button" | "reset" | "submit";
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLButtonElement>;
+    readonly plain: boolean;
+    readonly nativeType: "button" | "submit" | "reset";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    buttonRef: HTMLButtonElement;
+}, HTMLButtonElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/cell/index.d.ts

@@ -35,12 +35,12 @@ export declare const MtCell: {
     }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
         click: () => any;
     }, import('vue').PublicProps, {
+        readonly width: string | number;
+        readonly title: string;
         readonly clickable: boolean;
+        readonly icon: string;
         readonly link: boolean;
-        readonly title: string;
-        readonly width: string | number;
         readonly height: string | number;
-        readonly icon: string;
         readonly description: string;
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, HTMLDivElement, import('vue').ComponentProvideOptions, {
         P: {};
@@ -83,12 +83,12 @@ export declare const MtCell: {
     }>> & Readonly<{
         onClick?: (() => any) | undefined;
     }>, {}, {}, {}, {}, {
+        readonly width: string | number;
+        readonly title: string;
         readonly clickable: boolean;
+        readonly icon: string;
         readonly link: boolean;
-        readonly title: string;
-        readonly width: string | number;
         readonly height: string | number;
-        readonly icon: string;
         readonly description: string;
     }>;
     __isFragment?: never;
@@ -130,28 +130,21 @@ export declare const MtCell: {
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     click: () => any;
 }, string, {
+    readonly width: string | number;
+    readonly title: string;
     readonly clickable: boolean;
+    readonly icon: string;
     readonly link: boolean;
-    readonly title: string;
-    readonly width: string | number;
     readonly height: string | number;
-    readonly icon: string;
     readonly description: string;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
-    $slots: Readonly<{
-        icon: any;
-        title: any;
-        description: any;
-        right: {
+    $slots: {
+        icon?(_: {}): any;
+        title?(_: {}): any;
+        description?(_: {}): any;
+        right?(_: {
             isHover: boolean;
-        };
-    }> & {
-        icon: any;
-        title: any;
-        description: any;
-        right: {
-            isHover: boolean;
-        };
+        }): any;
     };
 }) & import('vue').Plugin;
 export default MtCell;

package/dist/cell/src/cell.vue.d.ts

@@ -1,19 +1,12 @@
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Readonly<{
-        icon: any;
-        title: any;
-        description: any;
-        right: {
+    slots: {
+        icon?(_: {}): any;
+        title?(_: {}): any;
+        description?(_: {}): any;
+        right?(_: {
             isHover: boolean;
-        };
-    }> & {
-        icon: any;
-        title: any;
-        description: any;
-        right: {
-            isHover: boolean;
-        };
+        }): any;
     };
     refs: {};
     rootEl: HTMLDivElement;
@@ -86,12 +79,12 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
 }>> & Readonly<{
     onClick?: (() => any) | undefined;
 }>, {
+    readonly width: string | number;
+    readonly title: string;
     readonly clickable: boolean;
+    readonly icon: string;
     readonly link: boolean;
-    readonly title: string;
-    readonly width: string | number;
     readonly height: string | number;
-    readonly icon: string;
     readonly description: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;