joy-admin-components 0.2.88 → 0.2.90

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

@@ -0,0 +1,42 @@
+import { DefineComponent } from 'vue';
+import { SelectProps } from 'element-plus';
+/**
+ * 字典选择器组件 - 基于 Element Plus Select 封装
+ * 支持 API 请求数据、全选、多语言等功能
+ */
+export interface CmpDictionaryProps extends Partial<SelectProps> {
+  /** 获取下拉数据的 API 函数 */
+  api?: () => Promise<{ data: any[] }>;
+  /** 是否显示全选复选框（仅多选模式），默认 true */
+  showCheckAll?: boolean;
+  /** 选项点击回调函数 */
+  optionClick?: (item: any) => void;
+  /** 多选模式下的最大选择数量 */
+  maxLimit?: number;
+  /** 多选模式下的最小选择数量 */
+  minLimit?: number;
+  /** 静态数据源（如果提供则不使用 api） */
+  data?: any[];
+  /** 字段映射配置 */
+  labelValue?: {
+    label?: string;
+    labelEn?: string;
+    value?: string;
+  };
+  /** 是否使用本地 i18n 翻译 label，默认 false */
+  changeLocal?: boolean;
+  /** v-model 绑定值 */
+  modelValue?: any;
+}
+
+export interface CmpDictionaryEmits {
+  /** API 请求成功后触发 */
+  (e: 'success', data: any[]): void;
+  /** 选择值变化时触发 */
+  (e: 'change', value: any): void;
+  /** v-model 更新事件 */
+  (e: 'update:modelValue', value: any): void;
+}
+
+declare const CmpDictionary: DefineComponent<CmpDictionaryProps>;
+export default CmpDictionary;

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

@@ -0,0 +1,23 @@
+import { DefineComponent } from 'vue';
+/**
+ * 图标组件 - 基于 Element Plus Icon 封装
+ * 简化图标的使用，通过 name 属性指定图标名称
+ *
+ * @example
+ * ```vue
+ * <CmpIcon name="Edit" />
+ * <CmpIcon name="Delete" />
+ * <CmpIcon name="Search" />
+ * ```
+ */
+export interface CmpIconProps {
+  /**
+   * 图标名称
+   * 支持 Element Plus 所有图标名称
+   * @see https://element-plus.org/zh-CN/component/icon.html
+   */
+  name: string;
+}
+
+declare const CmpIcon: DefineComponent<CmpIconProps>;
+export default CmpIcon;

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

@@ -0,0 +1,18 @@
+import { DefineComponent } from 'vue';
+import { PopconfirmProps } from 'element-plus';
+/**
+ * 确认按钮组件 - 基于 Element Plus Popconfirm 封装
+ * 点击后弹出确认气泡，确认后执行操作（自动防抖 500ms）
+ * 继承 Element Plus ElPopconfirm 所有属性
+ */
+export type ConfrimButtonProps = Partial<PopconfirmProps>;
+
+export interface ConfrimButtonEmits {
+  /** 确认操作时触发（已防抖处理） */
+  (e: 'ok'): void;
+  /** 取消操作时触发 */
+  (e: 'no'): void;
+}
+
+declare const ConfrimButton: DefineComponent<ConfrimButtonProps>;
+export default ConfrimButton;

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

@@ -0,0 +1,19 @@
+import { DefineComponent } from 'vue';
+/**
+ * DownExcelTemp 组件 Props
+ */
+export interface DownExcelTempProps {
+  /**
+   * Excel 表配置
+   */
+  sheetsConfig: Record<string, any>;
+
+  /**
+   * 导出的文件名
+   */
+  fileName: string;
+}
+
+declare const DownExcelTemp: DefineComponent<DownExcelTempProps>;
+
+export default DownExcelTemp;

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

@@ -0,0 +1,19 @@
+import { DefineComponent } from 'vue';
+/**
+ * 导入按钮组件 - 文件上传按钮
+ * 点击按钮选择文件，支持自定义文件类型
+ */
+export interface ImportButtonProps {
+  /** 接受的文件类型，默认 '.xlsx,.xls' */
+  accept?: string;
+  /** 按钮加载状态 */
+  loading?: boolean;
+}
+
+export interface ImportButtonEmits {
+  /** 文件选择后触发 */
+  (e: 'fileChange', file: File): void;
+}
+
+declare const ImportButton: DefineComponent<ImportButtonProps>;
+export default ImportButton;

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

@@ -0,0 +1,19 @@
+import { DefineComponent } from 'vue';
+import { FormProps } from 'element-plus';
+/**
+ * LayOutForm 组件 - 带栅格布局的表单容器
+ * 继承 Element Plus ElForm 所有属性
+ * 自动为表单项添加栅格布局，支持多列表单
+ */
+export interface LayOutFormProps extends FormProps {
+  /** 栅格间隔，默认 20 */
+  gutter?: number;
+}
+
+export interface LayOutFormEmits {
+  /** 组件挂载完成后触发，返回表单 ref */
+  (e: 'ref', formRef: any): void;
+}
+
+declare const LayOutForm: DefineComponent<LayOutFormProps>;
+export default LayOutForm;

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

@@ -0,0 +1,34 @@
+import { DefineComponent } from 'vue';
+/**
+ * Layer 组件 - 弹层组件（支持 Dialog 和 Drawer 两种模式）
+ * 基于 Element Plus 的 Dialog 和 Drawer 封装
+ */
+export interface LayerConfig {
+  /** 是否显示弹层 */
+  show: boolean;
+  /** 弹层类型：'layer' 为 Dialog，'drawer' 为 Drawer */
+  type?: 'layer' | 'drawer';
+  /** 弹层标题 */
+  title?: string;
+  /** 弹层宽度，Dialog 默认 500，Drawer 默认 '100%' */
+  width?: string | number;
+  /** 是否显示底部按钮 */
+  showButton?: boolean;
+  /** 自定义关闭回调（仅 Drawer 模式有效） */
+  onClose?: () => void;
+}
+
+export interface LayerProps {
+  /** 弹层配置对象 */
+  layer: LayerConfig;
+  /** 确认按钮加载状态 */
+  loading?: boolean;
+}
+
+export interface LayerEmits {
+  /** 点击确认按钮时触发（已防抖 300ms） */
+  (e: 'confirm'): void;
+}
+
+declare const Layer: DefineComponent<LayerProps>;
+export default Layer;

package/dist/components/ListPage/config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * ListPage 全局配置
+ * 可在项目入口文件（如 main.js）中调用 setListPageConfig 进行全局配置
+ */
+export interface ListPageConfig {
+    /** 页码参数名 */
+    pageNoKey: string;
+    /** 每页条数参数名 */
+    pageSizeKey: string;
+    /** 总条数字段名 */
+    totalKey: string;
+    /** 默认每页条数 */
+    defaultPageSize: number;
+    /** 每页条数选项 */
+    pageSizes: number[];
+    /** 响应数据字段映射 */
+    responseDataKeys: {
+        /** 数据列表字段名（优先级从左到右） */
+        rows: string[];
+        /** 总条数字段名 */
+        total: string[];
+    };
+    /** 是否显示搜索栏 */
+    showSearch: boolean;
+    /** 是否显示分页 */
+    showPage: boolean;
+    /** 是否显示阴影 */
+    showShadow: boolean;
+    /** 是否显示复选框列 */
+    showCheckBox: boolean;
+    /** 是否启用单元格选区复制功能 */
+    enableCellCopy: boolean;
+}
+/**
+ * 设置全局配置
+ * @param config - 配置对象
+ */
+export declare function setListPageConfig(config: Partial<ListPageConfig>): void;
+/**
+ * 获取当前配置
+ * @returns 当前配置对象
+ */
+export declare function getListPageConfig(): ListPageConfig;
+/**
+ * 重置为默认配置
+ */
+export declare function resetListPageConfig(): void;

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

@@ -0,0 +1,91 @@
+import { DefineComponent } from 'vue';
+/** 搜索表单项 */
+export interface SearchFormItem {
+  /** 字段 key */
+  key: string;
+  /** 字段名称 */
+  name: string;
+  /** 字段值 */
+  value: any;
+  /** 表单项类型 */
+  type?: 'input' | 'select' | 'date' | 'custom' | 'br';
+  /** 日期类型 */
+  dateType?: 'date' | 'daterange' | 'datetimerange';
+  /** 是否隐藏 */
+  hidden?: boolean;
+  /** 自定义渲染函数（type 为 custom 时使用） */
+  render?: () => any;
+  /** 额外配置 */
+  option?: {
+    class?: string;
+    [key: string]: any;
+  };
+}
+
+/** 搜索表单配置 */
+export interface SearchFormConfig {
+  /** 表单项列表 */
+  items: SearchFormItem[];
+  /** 选中的行数据（多选） */
+  selections?: any[];
+  /** 是否显示搜索栏 */
+  showSearch?: boolean;
+  /** 是否显示分页 */
+  showPage?: boolean;
+  /** 是否显示阴影 */
+  showShadow?: boolean;
+  /** 是否显示复选框 */
+  showCheckBox?: boolean;
+}
+
+/** 表格配置 */
+export interface TableConfig {
+  /** 数据格式化函数 */
+  dataFormat?: (data: any[]) => any[];
+  /** 重置回调函数 */
+  reset?: () => void | Promise<void>;
+  /** 自定义配置 */
+  customConfig?: Record<string, any>;
+  /** 列配置 */
+  columnConfig?: Record<string, any>;
+  /** 表格高度 */
+  height?: number | string;
+  [key: string]: any;
+}
+
+/**
+ * ListPage 组件 - 列表页面容器
+ * 集成搜索栏、表格、分页等功能
+ * 基于 VxeTable 实现
+ */
+export interface ListPageProps {
+  /** 表格唯一标识，用于本地存储列设置 */
+  id: string;
+  /** 加载状态 */
+  loading?: boolean;
+  /** 是否立即请求数据，默认 true */
+  immediate?: boolean;
+  /** 搜索表单配置 */
+  searchForm?: SearchFormConfig;
+  /** 获取列表数据的 API 函数 */
+  api?: (params: any) => Promise<{ code: number; data: { rows: any[]; totalRows: number } }>;
+  /** 静态数据源（如果提供则不使用 api） */
+  data?: any[];
+  /** 表格配置 */
+  tableConfig?: TableConfig;
+}
+
+/** ListPage 暴露的方法 */
+export interface ListPageExpose {
+  /** VxeTable 实例 */
+  tableRef: any;
+  /** 刷新列表数据 */
+  getList: (params?: any) => void;
+  /** 获取当前搜索参数 */
+  getPrm: () => any;
+  /** 重新计算表格高度 */
+  calculateTableHeight: () => void;
+}
+
+declare const ListPage: DefineComponent<ListPageProps>;
+export default ListPage;

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

@@ -0,0 +1,50 @@
+import { DefineComponent } from 'vue';
+/** 搜索表单项 */
+export interface SearchBarFormItem {
+  /** 字段 key */
+  key: string;
+  /** 字段名称 */
+  name: string;
+  /** 字段值 */
+  value: any;
+  /** 表单项类型 */
+  type?: 'input' | 'select' | 'date' | 'custom' | 'br';
+  /** 日期类型 */
+  dateType?: 'date' | 'daterange' | 'datetimerange';
+  /** 是否隐藏 */
+  hidden?: boolean;
+  /** 自定义渲染函数（type 为 custom 时使用） */
+  render?: () => any;
+  /** 额外配置 */
+  option?: {
+    class?: string;
+    [key: string]: any;
+  };
+}
+
+/** 搜索表单配置 */
+export interface SearchBarForm {
+  /** 表单项列表 */
+  items: SearchBarFormItem[];
+  /** 表单数据对象 */
+  data?: Record<string, any>;
+}
+
+/**
+ * SearchBar 组件 - 搜索栏
+ * 支持多种表单项类型，可折叠展开
+ */
+export interface SearchBarProps {
+  /** 搜索表单配置 */
+  form: SearchBarForm;
+}
+
+export interface SearchBarEmits {
+  /** 筛选按钮点击时触发 */
+  (e: 'confirm'): void;
+  /** 重置按钮点击时触发 */
+  (e: 'reset'): void;
+}
+
+declare const SearchBar: DefineComponent<SearchBarProps>;
+export default SearchBar;

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

@@ -0,0 +1,72 @@
+/**
+ * 注册 VxeTable 格式化器
+ *
+ * 注册以下格式化器到 VxeUI：
+ * - formatNumber: 千分位数字格式化（默认 2 位小数）
+ * - formatMoney: 金额格式化（默认 2 位小数）
+ * - formatPercent: 百分比格式化（默认 2 位小数）
+ *
+ * @example
+ * ```ts
+ * import { registerVxeFormatters } from 'joy-admin-components';
+ *
+ * // 在应用初始化时注册
+ * registerVxeFormatters();
+ * ```
+ *
+ * @example
+ * ```vue
+ * <!-- 在表格列中使用 -->
+ * <vxe-column field="amount" title="金额" :formatter="['formatMoney', 2]" />
+ * <vxe-column field="quantity" title="数量" :formatter="['formatNumber', 0]" />
+ * <vxe-column field="rate" title="比率" :formatter="['formatPercent', 1]" />
+ * ```
+ *
+ * @requires vxe-pc-ui - VxeUI 库
+ */
+export function registerVxeFormatters(): void;
+
+/**
+ * 注册 VxeTable 渲染器
+ *
+ * 注册以下渲染器到 VxeUI：
+ * - Enum: 枚举值渲染器
+ * - InputNumber: 数字输入渲染器
+ * - TrueFalse: 真假值渲染器
+ * - I18n: 国际化渲染器
+ * - Link: 跳转链接渲染器
+ *
+ * @example
+ * ```ts
+ * import { registerVxeRenderers } from 'joy-admin-components';
+ *
+ * // 在应用初始化时注册
+ * registerVxeRenderers();
+ * ```
+ *
+ * @requires vxe-pc-ui - VxeUI 库
+ * @requires vue-router - Vue Router
+ * @requires vue-i18n - Vue I18n
+ */
+export function registerVxeRenderers(): void;
+
+/**
+ * 一次性注册所有 VxeTable 插件（渲染器和格式化器）
+ *
+ * 这是一个便捷方法，等价于依次调用：
+ * - registerVxeFormatters()
+ * - registerVxeRenderers()
+ *
+ * @example
+ * ```ts
+ * import { registerVxePlugins } from 'joy-admin-components';
+ *
+ * // 在应用初始化时一次性注册所有插件
+ * registerVxePlugins();
+ * ```
+ *
+ * @requires vxe-pc-ui - VxeUI 库
+ * @requires vue-router - Vue Router
+ * @requires vue-i18n - Vue I18n
+ */
+export function registerVxePlugins(): void;

package/dist/index.d.ts

@@ -1 +1,25 @@
-export {}
+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 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 * from './utils/index.js';
+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/ConfrimButton/index';
+export type * from './components/ImportButton/index';
+export type * from './components/ListPage/index';
+export type * from './components/SearchBar/index';
+export type * from './components/DownExcelTemp/index';
+export type * from './components/Layer/index';
+export type * from './utils/index';
+export type * from './components/VxeTable/index';

package/dist/joy-admin-components.css

@@ -1,2 +1,2 @@
-.cmp-icon[data-v-7b9ec6d8],.cmp-icon[data-v-733f9daa]{padding:0!important}.confirm-button-wrapper[data-v-24cb35fd],.ImportButton[data-v-b8f856ea]{vertical-align:middle;line-height:1;display:inline-block}.searchBar-container .searchBar[data-v-db6f71dd]{transition:all .3s;overflow:hidden}.searchBar-container[data-v-db6f71dd] .el-form-item{margin-bottom:8px!important}.searchBar-container .btns[data-v-db6f71dd]{justify-content:space-between;align-items:center;display:flex}.searchBar-container .btns .left[data-v-db6f71dd]{align-items:center;display:flex}.searchBar-container .btns .left[data-v-db6f71dd] .el-tabs__header{margin:0}.searchBar-container .btns .right[data-v-db6f71dd]{text-align:right;align-items:center;display:flex}[data-v-c022c16d] .vxe-table-custom-wrapper.placement--top-right.is--active{max-height:400px!important}[data-v-c022c16d] .vxe-table.cell-copy-enabled .vxe-body--column{-webkit-user-select:none;user-select:none}[data-v-c022c16d] .vxe-table.cell-copy-enabled .vxe-body--column.cell-selected{position:relative;background-color:#409eff26!important}[data-v-c022c16d] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-top:before{content:"";pointer-events:none;z-index:10;background-color:#409eff;height:1px;position:absolute;top:0;left:0;right:0}[data-v-c022c16d] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-bottom:after{content:"";pointer-events:none;z-index:10;background-color:#409eff;height:1px;position:absolute;bottom:0;left:0;right:0}[data-v-c022c16d] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-left{border-left:1px solid #409eff!important}[data-v-c022c16d] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-right{border-right:1px solid #409eff!important}.drawer-content .drawer-btn{box-sizing:border-box;text-align:right;z-index:10;background-color:#fff;width:100%;padding:10px 60px 20px 20px;position:absolute;bottom:0}
+.cmp-icon[data-v-7b9ec6d8],.cmp-icon[data-v-733f9daa]{padding:0!important}.confirm-button-wrapper[data-v-24cb35fd],.ImportButton[data-v-b8f856ea]{vertical-align:middle;line-height:1;display:inline-block}.searchBar-container .searchBar[data-v-db6f71dd]{transition:all .3s;overflow:hidden}.searchBar-container[data-v-db6f71dd] .el-form-item{margin-bottom:8px!important}.searchBar-container .btns[data-v-db6f71dd]{justify-content:space-between;align-items:center;display:flex}.searchBar-container .btns .left[data-v-db6f71dd]{align-items:center;display:flex}.searchBar-container .btns .left[data-v-db6f71dd] .el-tabs__header{margin:0}.searchBar-container .btns .right[data-v-db6f71dd]{text-align:right;align-items:center;display:flex}[data-v-8dbf5afd] .vxe-table-custom-wrapper.placement--top-right.is--active{max-height:400px!important}[data-v-8dbf5afd] .vxe-table.cell-copy-enabled .vxe-body--column{-webkit-user-select:none;user-select:none}[data-v-8dbf5afd] .vxe-table.cell-copy-enabled .vxe-body--column.cell-selected{position:relative;background-color:#409eff26!important}[data-v-8dbf5afd] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-top:before{content:"";pointer-events:none;z-index:10;background-color:#409eff;height:1px;position:absolute;top:0;left:0;right:0}[data-v-8dbf5afd] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-bottom:after{content:"";pointer-events:none;z-index:10;background-color:#409eff;height:1px;position:absolute;bottom:0;left:0;right:0}[data-v-8dbf5afd] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-left{border-left:1px solid #409eff!important}[data-v-8dbf5afd] .vxe-table.cell-copy-enabled .vxe-body--column.cell-border-right{border-right:1px solid #409eff!important}.drawer-content .drawer-btn{box-sizing:border-box;text-align:right;z-index:10;background-color:#fff;width:100%;padding:10px 60px 20px 20px;position:absolute;bottom:0}
 /*$vite$:1*/

package/dist/joy-admin-components.es.js

@@ -259,7 +259,7 @@ var fe = Object.create, J = Object.defineProperty, pe = Object.getOwnPropertyDes
 function Oe(e = null) {
 	if (e) {
 		let { global: t } = e;
-		return t.messages.value.zh_cn ? t.mergeLocaleMessage("zh_cn", we) : t.setLocaleMessage("zh_cn", we), t.messages.value.en_us ? t.mergeLocaleMessage("en_us", Te) : t.setLocaleMessage("en_us", Te), De = e, e;
+		return t.messages.value?.zh_cn ? t.mergeLocaleMessage("zh_cn", we) : t.setLocaleMessage("zh_cn", we), t.messages.value?.en_us ? t.mergeLocaleMessage("en_us", Te) : t.setLocaleMessage("en_us", Te), De = e, e;
 	}
 	return De ||= ie({
 		legacy: !1,
@@ -1114,7 +1114,7 @@ var St = { class: "center" }, Ct = /* @__PURE__ */ Z({
 		let { t: n, locale: r } = U(), i = ce(), a = bt(), o = e, s = A(!1), c = A([]);
 		o.searchForm.showSearch === void 0 && (o.searchForm.showSearch = a.showSearch), o.searchForm.showPage === void 0 && (o.searchForm.showPage = a.showPage), o.searchForm.showShadow === void 0 && (o.searchForm.showShadow = a.showShadow), o.searchForm.showCheckBox === void 0 && (o.searchForm.showCheckBox = a.showCheckBox), o.searchForm.enableCellCopy === void 0 && (o.searchForm.enableCellCopy = a.enableCellCopy), o.searchForm.selections || (o.searchForm.selections = []);
 		let m = l(() => {
-			let e = i.path.replace(/\//g, "-").replace(/^-/, "") || "default-table";
+			let e = i?.path.replace(/\//g, "-").replace(/^-/, "") || "default-table";
 			return o.id ? `listPageId-${e}-${o.id}` : `listPageId-${e}`;
 		}), _ = ae(o.searchForm.items), v = o.searchForm.pageNoKey || a.pageNoKey, y = o.searchForm.pageSizeKey || a.pageSizeKey, b = k({
 			[v]: 1,
@@ -1509,7 +1509,7 @@ var St = { class: "center" }, Ct = /* @__PURE__ */ Z({
 			], 2);
 		};
 	}
-}, [["__scopeId", "data-v-c022c16d"]]), wt = {
+}, [["__scopeId", "data-v-8dbf5afd"]]), wt = {
 	__name: "index",
 	props: {
 		sheetsConfig: {