dmx-admin-ui 1.2.209 → 1.2.211

package/types/admin.d.ts

@@ -0,0 +1,449 @@
+import {
+    type InputProps,
+    type InputNumberProps,
+    type SelectPropsPublic,
+    type CascaderComponentProps,
+    type DatePickerPropsPublic,
+    type TimePickerDefaultPropsPublic,
+    type SwitchProps,
+    type CheckboxProps,
+    type RadioProps,
+    type SliderPropsPublic,
+    type ColorPickerProps,
+    type TransferProps,
+    type AutocompleteProps,
+    type ButtonProps,
+    type FormItemRule,
+    type TagProps,
+    type ImageProps,
+} from 'element-plus'
+import { Component, StyleValue } from 'vue'
+/** 表单字段 */
+interface ColField {
+    /** 字段名 */
+    field?: string;
+    /** 字段标题 */
+    title?: string | false;
+    /** title 别名 */
+    label?: string | false;
+    tab?: number | number[];
+    labelWidth?: string;
+    class?: string;
+    colClass?: string;
+    colWidth?: string;
+    slot?: string | true;
+    placeholder?: string;
+    clearable?: boolean;
+    info?: string;
+    required?: boolean;
+    width?: number;
+    disabled?: boolean;
+    /** 缺省默认值 */
+    value?: any;
+    rules?: FormItemRule | FormItemRule[];
+    change?: (e: {
+        data: any, input: {
+            onChange: (e: any) => void;
+            setValue: (e: any) => void;
+            relatedUpdate: (field: any, e: any) => void;
+            prop: Record<string, any>;
+        }
+    }) => void;
+    changeField?: string[];
+    format?: Function
+}
+type ColsTypes = 'hidden' | 'text' | 'input-select' | 'radio-button' | 'editor' | 'tags' | 'map' | 'pickerMap' | 'region' | 'url' | 'img' | 'image' | 'file' | 'video' | 'audio'
+type KnownTypes = ColsTypes | 'input-button' | 'input-auto' | 'imgs' | 'group-table' | 'group' | 'group-tabs' | 'group-tabs-plus' | 'selects' | 'password' | 'textarea' | 'number' | 'color' | 'switch' | 'checkbox' | 'radio' | 'slider' | 'datetimes' | 'dates' | 'datetime' | 'date' | 'time' | 'times';
+
+interface AnyColField extends ColField {
+    type: ColsTypes;
+}
+interface OtherColField extends ColField {
+    /** 用户自定义类型 */
+    type: Omit<string, KnownTypes>;
+}
+interface DiyField extends ColField {
+    /** 自定义组件 */
+    component: string | Component
+}
+interface inputAutoField extends ColField {
+    type: 'input-auto';
+    /** input-auto 配置信息 */
+    list?: Record<string | number, string>;
+    /** el-autocomplete props属性
+     * @see https://element-plus.org/zh-CN/component/autocomplete#attributes
+     */
+    props?: AutocompleteProps;
+
+}
+interface inputBtnField extends ColField {
+    type: 'input-button'
+    /** input-button Props */
+    props: {
+        /** el-input props属性
+     * @see https://element-plus.org/zh-CN/component/input#attributes
+     */
+        props?: InputProps;
+        btn: {
+            icon?: string
+            text: string
+            click: (value: any) => any | Promise<any>
+        }
+    }
+}
+interface ImgsField extends ColField {
+    type: 'imgs' | 'images';
+    limit?: number;
+    tips?: string;
+    cateId?: Number;
+    props?: Record<string, any>;
+}
+interface GroupTableField extends ColField {
+    type: 'group-table' | 'group';
+    limit?: number;
+    cols?: (FormCol & { inputWidth?: string })[];
+    props?: Record<string, any>;
+}
+interface GroupTabsField extends ColField {
+    type: 'group-tabs' | 'group-tabs-plus';
+    limit?: number;
+    tabs?: Function | Record<string, any>;
+    cols?: (FormCol & { inputWidth?: string })[] | (FormCol & { inputWidth?: string });
+    props?: Record<string, any>;
+}
+interface InputField extends ColField {
+    type?: 'input';
+    /** el-input props属性
+     * @see https://element-plus.org/zh-CN/component/input#attributes
+     */
+    props?: InputProps
+}
+interface SelectField extends ColField {
+    type: 'select';
+    /** 配置信息 */
+    cols?: { value: number | string | boolean, label: string }[] | Record<string, number | string | boolean> | string[];
+    /** api接口 或者配置信息
+     * 字符串模式 只在admin-table下的表单有效
+     * 数组或对象模式 url是兼容处理 请使用cols配置
+     */
+    url?: { value: number | string | boolean, label: string }[] | Record<string, number | string | boolean> | string[] | string;
+    /** el-select props属性
+     * @see https://element-plus.org/zh-CN/component/select#select-attributes
+     */
+    props?: SelectPropsPublic
+}
+interface SliderField extends ColField {
+    type: 'slider';
+    /** el-slider props属性
+     * @see https://element-plus.org/zh-CN/component/slider#%E5%B1%9E%E6%80%A7
+     */
+    props?: SliderPropsPublic
+}
+interface TextareaField extends ColField {
+    type: 'textarea';
+    /** el-input props属性
+      * @see https://element-plus.org/zh-CN/component/input#attributes
+      */
+    props?: InputProps
+}
+interface PassField extends ColField {
+    type: 'password';
+    /** el-input props属性
+      * @see https://element-plus.org/zh-CN/component/input#attributes
+      */
+    props?: InputProps
+}
+interface SwitchField extends ColField {
+    type: 'switch';
+    cols?: [0 | false, 1 | true] | [0 | false, 1 | true, string, string];
+    /** el-switch props属性
+     * @see https://element-plus.org/zh-CN/component/switch#attributes
+     */
+    props?: SwitchProps
+}
+interface CheckboxField extends ColField {
+    type: 'checkbox';
+    /** el-checkbox props属性
+    * @see https://element-plus.org/zh-CN/component/checkbox#checkbox-attributes
+    */
+    props?: CheckboxProps;
+}
+interface RadioField extends ColField {
+    type: 'radio';
+    /** el-radio props属性
+    * @see https://element-plus.org/zh-CN/component/radio#radio-attributes
+    */
+    props?: RadioProps;
+    /** 配置信息 */
+    cols?: { value: number | string | boolean, label: string }[] | Record<string, number | string | boolean> | string[];
+}
+interface ColorField extends ColField {
+    type: 'color';
+    /** el-color-picker props属性
+     * @see https://element-plus.org/zh-CN/component/color-picker#attributes
+     */
+    props?: ColorPickerProps;
+}
+interface NumberField extends ColField {
+    type: 'number';
+    /** el-input-number props属性
+     * @see https://element-plus.org/zh-CN/component/input-number#attributes
+     */
+    props?: InputNumberProps;
+}
+interface DateField extends ColField {
+    type: 'datetimes' | 'dates' | 'datetime' | 'date';
+    /** el-date-picker props属性
+     * @see https://element-plus.org/zh-CN/component/date-picker#%E5%B1%9E%E6%80%A7
+     */
+    props?: DatePickerPropsPublic;
+}
+interface TimeField extends ColField {
+    type: 'time' | 'times';
+    /** el-time-picker props属性
+     * @see https://element-plus.org/zh-CN/component/time-picker#attributes
+     */
+    props?: TimePickerDefaultPropsPublic;
+}
+interface CascaderField extends ColField {
+    type: 'selects';
+    /** el-cascader props属性
+     * @see https://element-plus.org/zh-CN/component/cascader#cascader-attributes
+     */
+    props?: CascaderComponentProps;
+    /** api接口 或者配置信息
+     * @example
+     * url: 'api/goods_cate'
+     * url: ['分类1', '分类2']
+     * url: [{title:'分类1',id:1},{title:'分类2',id:2},{title:'分类1-1',id:3,pid:1}]
+     * url: {cate1: '分类1', cate2: '分类1' }
+     */
+    url: string | string[] | { title: string, id: number | string, pid?: number | string }[] | { [key: string]: string };
+}
+export type FormCol = CascaderField | PassField | ImgsField | GroupTableField | NumberField | SelectField | SliderField | InputField | TextareaField | DateField | TimeField | SwitchField | ColorField | RadioField | CheckboxField | GroupTabsField | inputBtnField | inputAutoField | AnyColField | DiyField | OtherColField;
+export interface AdminFormInit {
+    confirmButton?: Record<string, any>;
+    url?: string | Function;
+    /** 表单宽度 字符串
+     * @example
+     * '50%'
+     * '500px'
+     * 
+     */
+    width?: string;
+    /** 数据未改变时是否提示 默认true */
+    noChangeTip?: boolean;
+    beforeSubmit?: (data: Record<string, any>) => void;
+    /** 表单字段列表 */
+    cols?: FormCol[];
+    colWidth?: string
+    colClass?: string
+    buttonFixed?: true
+    buttonText?: string
+    tabs?: string[];
+    btns?: {
+        title: string;
+        type?: ButtonType;
+        action: Function;
+        confirm?: boolean;
+
+    }[]
+}
+export type ButtonType = ButtonProps['type']
+/** 删除配置 */
+interface DeleteConfig {
+    url: string | ((e: Record<string, any>) => void);
+}
+
+/** 标签页配置 */
+interface TabConfig {
+    title: string;
+    where?: Record<string, any>;
+}
+/** 表格列基础类型 */
+interface BaseCol {
+    /** 字段名 */
+    field?: string;
+    /** 列标题 */
+    title?: string;
+    /** 列子标题 */
+    subTitle?: string;
+    slot?: string | true;
+    width?: number;
+    edit?: boolean;
+    /** 
+            * 列点击事件
+            * @param row - 当前行的数据对象
+            */
+    on?: (row: Record<string, any>) => void;
+    sort?: boolean;
+    color?: string;
+    class?: string;
+    format?: (value: any) => any;
+    /** tabs索引 */
+    tab?: number | number[];
+    align?: 'left' | 'center' | 'right';
+    /** 缺省默认值 */
+    default?: string | number | boolean;
+}
+/** 基础列 */
+interface AnyCol {
+    /** 列类型 */
+    type?: 'index' | 'region' | 'time' | 'times' | 'link' | 'img-info' | 'text' | 'imgs' | 'img' | 'checkbox';
+}
+/** 操作按钮 */
+interface ToolButton {
+    title?: string;
+    action: 'edit' | 'del' | 'detail' | ((row: Record<string, any>, index: number) => void);
+    /** tabs索引 */
+    tab?: number | number[];
+    /** 是否显示确认框 */
+    confirm?: boolean;
+}
+
+/** 操作栏列 */
+interface ToolCol {
+    type: 'tool';
+    before?: (row: Record<string, any>) => void;
+    /** 工具栏按钮 */
+    btn: ToolButton[];
+
+}
+type CSSColor =
+    | `#${string}` // 十六进制
+    | `rgb(${number}, ${number}, ${number})`
+    | `rgba(${number}, ${number}, ${number}, ${number})`
+    | `hsl(${number}, ${number}%, ${number}%)`
+    | `hsla(${number}, ${number}%, ${number}%, ${number})`
+    | `var(--${string})`
+    ;
+/** 状态列 */
+interface StatusCol {
+    type: 'status';
+    cols?: { [key: number | string]: [string, '' | 'primary' | 'on' | 'info' | 'end' | 'info' | 'warning' | 'danger' | 'success' | CSSColor] };
+}
+/** (text)文本列 */
+interface TextCol {
+    type: 'text';
+    /** 文本样式 */
+    textClass?: string;
+    cols?: Record<string | number, string>;
+}
+/** 图片列 */
+interface ImgCol {
+    type: 'img' | 'imgs' | 'image' | 'images';
+    /** 图片宽度 图片类型使用这个参数 避免和列宽度冲突，可用此值设置图片宽度 */
+    imgWidth?: string;
+    /** 
+     * 图片高度 请使用 imgWidth
+     * @deprecated
+     *  */
+    width?: string;
+    height?: string;
+    /** el-image props属性
+     * @see https://element-plus.org/zh-CN/component/image#image-attributes
+     */
+    props: ImageProps;
+}
+/** (tags)标签列 */
+interface TagsCol {
+    type: 'tags';
+    tagsType?: TagProps['type'];
+    cols: Record<string | number, string | [string, TagProps['type']]>;
+}
+/** (switch)开关列 */
+interface SwitchCol {
+    type: 'switch';
+    cols?: [0 | false, 1 | true] | [0 | false, 1 | true, string, string];
+    /** el-switch props属性
+     * @see https://element-plus.org/zh-CN/component/switch#attributes
+     */
+    props?: SwitchProps;
+}
+/** cate列 */
+interface CateCol {
+    type: 'cate';
+    url?: string;
+}
+/** 表格列类型 */
+type TableCol = BaseCol | ToolCol | StatusCol | CateCol | SwitchCol | TagsCol | TextCol | ImgCol | AnyCol;
+
+/** 工具栏按钮 */
+interface ToolItem {
+    title?: string;
+    icon?: string;
+    type?: ButtonType;
+    action?: 'add' | Function;
+    confirm?: boolean;
+}
+
+
+/** 搜索配置 */
+interface SearchConfig {
+    cols: FormCol[];
+}
+/** api请求 */
+type BatchActionUrl = string | ((data) => { code: number, msg: string })
+/** 批量操作 */
+interface BatchAction {
+    title: string;
+    action: 'del' | ((data) => void) | {
+        /** 批量操作附加数据 */
+        data: any
+        /** 批量操作api 已废弃 请使用url
+         * @deprecated
+         */
+        api?: string
+        /** 批量操作api */
+        url?: string
+    };
+    confirm?: boolean;
+}
+interface adminTableFrom extends AdminFormInit {
+    title?: string | false;
+}
+/** admin-table init */
+export interface AdminTableInit {
+    url?: string;
+    data?: Record<string, any>[] | ((data: {
+        page: number;
+        limit: number;
+        where?: Record<string, any>;
+        sort?: string;
+    }) => { data: Record<string, any>[], count: number });
+    title?: string | false;
+    rowHeight?: number;
+    page?: boolean | number;
+    limit?: number;
+    pageSizes?: number[]
+    pk?: string
+    /** 操作缓存标识 */
+    name?: string;
+    /** 是否树形结构 */
+    tree?: boolean;
+    /** api请求前处理 包含表格里的删除 修改 添加 等APi请求
+     * @param url 请求url
+     * @param data 请求参数
+     * @returns 返回false则取消请求 返回对象替换请求数据 返回字符串提示错误 不返回则正常请求
+     * 
+     */
+    apiBefore?: (url: string, data: Record<string, any>) => string | void | false | Record<string, any>;
+    /** api请求成功后监听
+   * @param type api操作类型
+    * @param data 参数1 uniApi|cellEdit|dialogSubmit类型->准备提交的数据
+    * @param data2 参数2 uniApi|dialogSubmit类型 -> url cellEdit类型 ->当前行索引
+    */
+    apiSuccess?: (type: string, data: any, data2?: any) => void;
+    tabs?: TabConfig[];
+    edit?: adminTableFrom;
+    detail?: adminTableFrom;
+    del?: DeleteConfig;
+    add?: adminTableFrom;
+    /** 表格列
+     *  @see https://dmx-docs.netlify.app/admin/admin-table.html#_1-basecol-%E5%9F%BA%E7%A1%80%E5%88%97
+     */
+    cols: TableCol[];
+    tools?: ToolItem[];
+    search?: SearchConfig;
+    batch?: BatchAction[];
+}

package/types/global.d.ts

@@ -8,6 +8,7 @@ const reqs = new req({})
 const pages = new page({})
 import np from "number-precision";
 import { dayjs as dayjss } from 'element-plus'
+import { AdminTableInit, AdminFormInit } from './admin';
 export { };
 interface Config {
     apis: {
@@ -63,27 +64,63 @@ declare global {
     const $prompt: typeof layer.prompt
     const $theme: { [key: string]: string }
     const $store: { [key: string]: string }
-    const $cache:typeof cache
+    const $cache: typeof cache
     const $config: Config
     const dayjs: typeof dayjss
     const $langs: { [key: string]: string }
     const $fileUrl: (url: string) => string
-    const loadjs:typeof load
+    const loadjs: typeof load
     /** [宏]导入指定文件下的vue组件 从项目根目录开始  */
-    const $macroComponents : (dir:string)=>{}
+    const $macroComponents: (dir: string) => {}
+    /** admin-table组件 init */
+    const adminTableInit: (init: AdminTableInit) => AdminTableInit
+    const adminFormInit: (init: AdminFormInit) => AdminFormInit
+/** 比较操作符类型 */
+type ComparisonOperator = 
+    | '='      // 等于
+    | '!='      // 不等于
+    | '>'      // 大于
+    | '>='     // 大于等于
+    | '<'      // 小于
+    | '<='     // 小于等于
+    | 'in'      // 在数组中
+    | '!in'     // 不在数组中
+    | 'contains'    // 包含字符串
+    | 'startsWith'  // 以...开头
+    | 'endsWith'    // 以...结尾
+    | '>time'      // 日期大于
+    | '<time';     // 日期小于
+/**
+ * 数据搜索函数
+ * 
+ * @param data - 数据数组
+ * @param option - 搜索选项
+ *   - page: 页码
+ *   - limit: 每页数量
+ *   - where: 过滤条件
+ *   - sort: 排序字段
+ * @param comparisonOperators - 比较运算符映射
+ */
+    const dataSearch: (data: Record<string, any>[], option: {
+        page: number;
+        limit: number;
+        where?: Record<string, any>;
+        sort?: string;
+    },
+        comparisonOperators?: Record<string,((itemValue:any, targetValue:any)=>boolean) | ComparisonOperator>) => { data: Record<string, any>[], count: number }
 }
 declare module 'vue' {
     interface ComponentCustomProperties {
-      $root:InstanceType<typeof root>
-      $config: typeof config
-      $go: typeof pages
-  }
+        $root: InstanceType<typeof root>
+        $config: typeof config
+        $go: typeof pages
+    }
 }
 
-import {ElImage} from "element-plus";
-interface  _default  {
+import { ElImage } from "element-plus";
+interface _default {
     AdminTable: {
-        new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
+        new(...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
             init: ObjectConstructor;
         }>> & Readonly<{
             onChange?: (...args: any[]) => any;
@@ -594,7 +631,77 @@ interface  _default  {
         locale: string;
         threshold: unknown[];
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
-    AImage: import('vue').DefineSetupFnComponent<Record<string, any>, {}, {}, Record<string, any> & {}, import('vue').PublicProps>;
+    AImage: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
+        src: StringConstructor;
+        width: {
+            type: (StringConstructor | NumberConstructor)[];
+        };
+        height: {
+            type: (StringConstructor | NumberConstructor)[];
+        };
+        background: {
+            type: StringConstructor;
+            default: string;
+        };
+        borderRadius: StringConstructor;
+        css: StringConstructor;
+        process: {
+            type: StringConstructor;
+            default: string;
+        };
+        lazy: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        index: {
+            type: NumberConstructor;
+            default: number;
+        };
+        preview: {
+            type: (ArrayConstructor | BooleanConstructor)[];
+            default: boolean;
+        };
+    }>, {}, {
+        previewSrcList: never[];
+    }, {}, {
+        addUnit(value: string | number): string;
+    }, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
+        src: StringConstructor;
+        width: {
+            type: (StringConstructor | NumberConstructor)[];
+        };
+        height: {
+            type: (StringConstructor | NumberConstructor)[];
+        };
+        background: {
+            type: StringConstructor;
+            default: string;
+        };
+        borderRadius: StringConstructor;
+        css: StringConstructor;
+        process: {
+            type: StringConstructor;
+            default: string;
+        };
+        lazy: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        index: {
+            type: NumberConstructor;
+            default: number;
+        };
+        preview: {
+            type: (ArrayConstructor | BooleanConstructor)[];
+            default: boolean;
+        };
+    }>> & Readonly<{}>, {
+        background: string;
+        process: string;
+        lazy: boolean;
+        index: number;
+        preview: boolean | unknown[];
+    }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
     AImageText: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
         modelValue: {
             type: (ObjectConstructor | ArrayConstructor)[];
@@ -732,7 +839,7 @@ interface  _default  {
         status: string;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
     ADraggable: {
-        new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
+        new(...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
             options: ObjectConstructor;
             list: {
                 type: ArrayConstructor;
@@ -993,7 +1100,7 @@ interface  _default  {
         };
     });
     AChart: {
-        new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
+        new(...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
             init: {
                 type: ObjectConstructor;
                 default: () => {};
@@ -1110,28 +1217,28 @@ interface  _default  {
 }
 declare module 'vue' {
     interface GlobalComponents {
-    AdminTable: _default['AdminTable']
-    AdminForm: _default['AdminForm']
-    DataApi: _default['DataApi']
-    ASearch: _default['ASearch']
-    AInputs: _default['AInputs']
-    InputButton: _default['InputButton']
-    ASearchBox: _default['ASearchBox']
-    ATip: _default['ATip']
-    ATextEdit: _default['ATextEdit']
-    ACateText: _default['ACateText']
-    ACascader: _default['ACascader']
-    ATags: _default['ATags']
-    ATime: _default['ATime']
-    AImage:_default['AImage'] & typeof ElImage
-    AImageText: _default['AImageText']
-    AColorPicker: _default['AColorPicker']
-    ARegionPicker: _default['ARegionPicker']
-    ARegionText: _default['ARegionText']
-    ARegionMap: _default['ARegionMap']
-    ATextStatus: _default['ATextStatus']
-    ADraggable: _default['ADraggable']
-    AChart: _default['AChart']
-    AEditor: _default['AEditor']
-}
+        AdminTable: _default['AdminTable']
+        AdminForm: _default['AdminForm']
+        DataApi: _default['DataApi']
+        ASearch: _default['ASearch']
+        AInputs: _default['AInputs']
+        InputButton: _default['InputButton']
+        ASearchBox: _default['ASearchBox']
+        ATip: _default['ATip']
+        ATextEdit: _default['ATextEdit']
+        ACateText: _default['ACateText']
+        ACascader: _default['ACascader']
+        ATags: _default['ATags']
+        ATime: _default['ATime']
+        AImage: _default['AImage'] & typeof ElImage
+        AImageText: _default['AImageText']
+        AColorPicker: _default['AColorPicker']
+        ARegionPicker: _default['ARegionPicker']
+        ARegionText: _default['ARegionText']
+        ARegionMap: _default['ARegionMap']
+        ATextStatus: _default['ATextStatus']
+        ADraggable: _default['ADraggable']
+        AChart: _default['AChart']
+        AEditor: _default['AEditor']
+    }
 }

package/types/plugins/cache.d.ts

@@ -1,8 +1,8 @@
-declare const _default: {
-    list: () => any[];
-    set: (key: any, value: any, time?: number | string) => void;
-    remove: (key: any) => void;
-    clear: () => void;
-    get: (key: any, type?: boolean) => any;
-};
-export default _default;
+declare const _default: {
+    list: () => any[];
+    set: (key: any, value: any, time?: number | string) => void;
+    remove: (key: any) => void;
+    clear: () => void;
+    get: (key: any, type?: boolean) => any;
+};
+export default _default;