joy-admin-components 0.2.104 → 0.2.105

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

@@ -40,3 +40,11 @@ export interface CmpDictionaryEmits {
 
 declare const CmpDictionary: DefineComponent<CmpDictionaryProps>;
 export default CmpDictionary;
+ Partial<{}>;
+    slots: {
+        header?(_: {}): any;
+        header?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};

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

@@ -0,0 +1,29 @@
+import { DefineComponent } from 'vue';
+/**
+ * CmpTag 组件 - 自定义颜色标签
+ * 基于 Element Plus Tag 封装，支持通过 fontColor 属性自定义标签颜色
+ *
+ * @example
+ * ```vue
+ * <!-- 自定义颜色 -->
+ * <CmpTag fontColor="#ff6600">进行中</CmpTag>
+ * <CmpTag fontColor="#52c41a">已完成</CmpTag>
+ *
+ * <!-- 不传 fontColor 时使用 Element Plus 默认样式 -->
+ * <CmpTag>默认标签</CmpTag>
+ *
+ * <!-- 支持 Element Plus Tag 的所有属性 -->
+ * <CmpTag fontColor="#f56c6c" closable @close="handleClose">可关闭</CmpTag>
+ * ```
+ */
+export interface CmpTagProps {
+  /**
+   * 自定义标签颜色
+   * 传入后会自动计算背景色（5% 透明度混合）和边框色
+   * 不传则使用 Element Plus Tag 默认样式
+   */
+  fontColor?: string;
+}
+
+declare const CmpTag: DefineComponent<CmpTagProps>;
+export default CmpTag;

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

@@ -1,19 +1,45 @@
 import { DefineComponent } from 'vue';
 /**
- * DownExcelTemp 组件 Props
+ * DownExcelTemp 组件 - 下载 Excel 导入模板
+ * 点击后根据配置生成并下载 Excel 模板文件
+ *
+ * @example
+ * ```vue
+ * <DownExcelTemp :sheetsConfig="config" fileName="商品导入模板" :version="1" />
+ * ```
  */
 export interface DownExcelTempProps {
   /**
-   * Excel 表配置
+   * Excel 多 sheet 配置
+   * key 为 sheet 名称，value 为该 sheet 的表头和数据配置
    */
-  sheetsConfig: Record<string, any>;
-
+  sheetsConfig: Record<
+    string,
+    {
+      tableHeader: Array<{
+        header: string;
+        key: string;
+        width?: number;
+        style?: any;
+        option?: Array<{ label: any; value: any }>;
+        required?: boolean;
+        numFmt?: string;
+        locked?: boolean;
+        optionFormater?: (item: any) => string;
+      }>;
+      tableData?: any[];
+      sort?: number;
+    }
+  >;
+  /** 导出的文件名 */
+  fileName: string;
   /**
-   * 导出的文件名
+   * 模板版本号
+   * 指定后文件名格式为：{fileName}__v{version}.xlsx
+   * 配合 ImportButton 的 version 属性做版本校验
    */
-  fileName: string;
+  version?: number;
 }
 
 declare const DownExcelTemp: DefineComponent<DownExcelTempProps>;
-
 export default DownExcelTemp;

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

@@ -1,18 +1,32 @@
 import { DefineComponent } from 'vue';
 /**
- * 导入按钮组件 - 文件上传按钮
- * 点击按钮选择文件，支持自定义文件类型
+ * 导入按钮组件 - Excel 文件导入
+ * 点击按钮选择 Excel 文件，自动解析后调用回调函数
+ *
+ * @example
+ * ```vue
+ * <ImportButton :fields="importFields" :fileChange="handleImport" :version="1" />
+ * ```
  */
 export interface ImportButtonProps {
   /** 接受的文件类型，默认 '.xlsx,.xls' */
   accept?: string;
-  /** 按钮加载状态 */
-  loading?: boolean;
-}
-
-export interface ImportButtonEmits {
-  /** 文件选择后触发 */
-  (e: 'fileChange', file: File): void;
+  /**
+   * 字段映射配置，按 sheet 名称组织
+   * 格式：{ 'Sheet名': { 字段名: '列字母' | '列字母---option' | '列字母---image' } }
+   */
+  fields?: Record<string, Record<string, string>>;
+  /**
+   * 文件解析完成的回调函数
+   * @param data 按 sheet 名称组织的解析结果
+   * @returns Promise，组件会等待 Promise 完成后恢复按钮状态
+   */
+  fileChange: (data: Record<string, any[]>) => Promise<void>;
+  /**
+   * 模板版本号校验
+   * 指定后会校验文件名中的版本号（格式：xxx__v{n}.xlsx），不匹配则拒绝导入
+   */
+  version?: number;
 }
 
 declare const ImportButton: DefineComponent<ImportButtonProps>;

package/dist/directive/index.d.ts

@@ -0,0 +1,86 @@
+import { App, Directive } from 'vue';
+/**
+ * v-auth 权限指令
+ * 根据用户角色权限列表控制元素是否显示
+ *
+ * @example
+ * ```vue
+ * <el-button v-auth:edit>编辑</el-button>
+ * <el-button v-auth:delete>删除</el-button>
+ * ```
+ */
+export declare const auth: Directive;
+
+/**
+ * v-copy 复制指令
+ * 点击元素时将绑定值复制到剪贴板
+ *
+ * @example
+ * ```vue
+ * <el-button v-copy="textValue">复制</el-button>
+ * ```
+ */
+export declare const copy: Directive;
+
+/**
+ * v-debounce 防抖指令
+ * 为按钮添加点击防抖（200ms）
+ *
+ * @example
+ * ```vue
+ * <el-button v-debounce="handleClick">提交</el-button>
+ * ```
+ */
+export declare const debounce: Directive;
+
+/**
+ * v-drag 弹窗拖拽指令
+ * 用于 Element Plus Dialog 的拖拽功能
+ *
+ * @example
+ * ```vue
+ * <div v-drag="dialogVisible">
+ *   <el-dialog v-model="dialogVisible">...</el-dialog>
+ * </div>
+ * ```
+ */
+export declare const drag: Directive;
+
+/**
+ * v-dragable 元素拖拽指令
+ * 使元素可在父级范围内自由拖拽
+ *
+ * @example
+ * ```vue
+ * <div v-dragable>可拖拽元素</div>
+ * <div v-dragable="'father'">在父级内拖拽</div>
+ * <div v-dragable="'#app'">在指定容器内拖拽</div>
+ * ```
+ */
+export declare const dragable: Directive;
+
+/**
+ * v-waterMarker 水印指令
+ * 为元素添加水印背景
+ *
+ * @example
+ * ```vue
+ * <div v-waterMarker="{ text: '机密文件', textColor: 'rgba(0,0,0,0.1)' }">
+ *   内容
+ * </div>
+ * ```
+ */
+export declare const waterMarker: Directive;
+
+/**
+ * 注册所有自定义指令到 Vue 应用
+ * @param app Vue 应用实例
+ */
+export default function useDirective(app: App): void;
+
+/**
+ * 权限检查函数
+ * @param binding 指令绑定对象
+ * @returns 是否有权限
+ */
+export declare function checkAuth(binding: { arg?: string }): boolean;

package/dist/index.d.ts

@@ -1,20 +1,22 @@
 import { default as LayOutForm } from './components/LayOutForm/index';
 import { default as CmpDictionary } from './components/CmpDictionary/index';
 import { default as CmpIcon } from './components/CmpIcon/index';
+import { default as CmpTag } from './components/CmpTag/index';
 import { default as ConfrimButton } from './components/ConfrimButton/index';
 import { default as ImportButton } from './components/ImportButton/index';
 import { default as ListPage } from './components/ListPage/index';
 import { default as SearchBar } from './components/SearchBar/index';
 import { default as DownExcelTemp } from './components/DownExcelTemp/index';
 import { default as Layer } from './components/Layer/index';
-export { LayOutForm, CmpDictionary, CmpIcon, ConfrimButton, ImportButton, ListPage, SearchBar, DownExcelTemp, Layer, };
+export { LayOutForm, CmpDictionary, CmpIcon, CmpTag, ConfrimButton, ImportButton, ListPage, SearchBar, DownExcelTemp, Layer, };
 export * from './utils/index.js';
-export { registerVxeFormatters, registerVxeRenderers, registerVxePlugins } from './components/VxeTable/index.jsx';
+export { registerVxeFormatters, registerVxeRenderers, registerVxePlugins, } from './components/VxeTable/index.jsx';
 export { setupI18n, getI18n, getI18nT, zh_cn, en_us, messages } from './locales/index';
 export { setListPageConfig, getListPageConfig, resetListPageConfig } from './components/ListPage/config';
 export type * from './components/LayOutForm/index';
 export type * from './components/CmpDictionary/index';
 export type * from './components/CmpIcon/index';
+export type * from './components/CmpTag/index';
 export type * from './components/ConfrimButton/index';
 export type * from './components/ImportButton/index';
 export type * from './components/ListPage/index';