@done-coding/admin-core 0.0.1-alpha.0

package/types/components/form/types.d.ts

@@ -0,0 +1,223 @@
+import { FormItemRule, ColProps, FormItemProps } from 'element-plus';
+import { VNode } from 'vue';
+
+export type OnlyOneKey<T extends Record<string, any>> = {
+    [K in keyof T]: {
+        [P in K]?: T[P];
+    } & Partial<Record<Exclude<keyof T, K>, never>>;
+}[keyof T];
+/** 额外扩展表单配置项 */
+export type FormItemConfigExtra = OnlyOneKey<{
+    /** 是输入类型 */
+    isInput: boolean;
+    /** 是选择类型 */
+    isSelect: boolean;
+}> & {
+    /** 回车提交 */
+    enterSubmit?: boolean;
+    /** 失去焦点提交[isInput默认为true] */
+    blurSubmit?: boolean;
+    /** 变化提交 [isSelect默认为true] */
+    changeSubmit?: boolean;
+};
+interface WrapProps extends FormItemProps {
+    [key: string]: any;
+}
+/** formItem联动配置 */
+interface FormItemLinkConfig<K extends string, BV, OV> {
+    /** 关联(该宿主配置)表单项的key */
+    key: K;
+    /**
+     * 获取该项的值
+     * @param hostValue 宿主/依赖项的值
+     * @param ownValue 该(寄生/收集依赖)项的值
+     * @param attachInfo 附加信息，可用于表单渲染为自定义组件时触发事件triggerChangeLink, 此场景 寄生项的值内部会去拿
+     * @example emit('triggerChangeLink', hostValue, attachInfo)
+     */
+    getValue: (hostValue: BV, ownValue: OV, attachInfo?: any) => void;
+}
+/** formItem配置 */
+export interface FormItemConfig<PO extends Record<string, any> = Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any> = Record<string, any>, 
+/** 解析的模型的key */
+PK extends Extract<keyof PO, string> = Extract<keyof PO, string>, 
+/** 解析的模型的值 */
+PV extends PO[PK] = PO[PK], 
+/** 需要格式化的模型的值 */
+SV extends PK extends keyof SO ? SO[PK] : PV = PK extends keyof SO ? SO[PK] : PV> {
+    /** 表单项key __大写视为忽略 等价于 ignore = true */
+    key: PK;
+    /** 表单项label */
+    label: string;
+    /** 提示信息 */
+    tip?: string | (() => VNode);
+    /** 表单布局 优先级高于FormMain同名属性 */
+    layout?: Partial<ColProps>;
+    /** 表单外FormItem属性 */
+    wrapProps?: Partial<WrapProps> | ((scope: FormScope<PO, SO, PK, PV, SV>) => Partial<WrapProps>);
+    /** 表单主体属性 */
+    props?: Record<string, any> | ((scope: FormScope<PO, SO, PK, PV, SV>) => Record<string, any>);
+    /** 表单渲染函数/渲染标签/组件 */
+    render?: string | Record<string, any> | ((props: {
+        modelValue: PV;
+        ["onUpdate:modelValue"]: (value: PV) => void;
+        placeholder?: string;
+        ["onTriggerChangeLink"]?: (value: SV, attachInfo?: any) => void;
+    } & Record<string, any>) => VNode);
+    /** 表单校验规则 */
+    rules?: FormItemRule[] | ((scope: FormScope<PO, SO, PK, PV, SV>) => FormItemRule[]);
+    /** 表单初始值 */
+    init?: (() => PV) | PV;
+    /** 表单回显解析处理 */
+    parse?: (value: any, parseData: Partial<PO>, originData: ExtractFormStringifyFromObject<PO, SO>) => PV | undefined;
+    /** 表单序列化处理 */
+    stringify?: (value: any, stringifyData: Partial<ExtractFormStringifyFromObject<PO, SO>>, originData: PO) => SV | undefined;
+    /**
+     * 是否在初始化数据、解析数据、序列化数据时忽略处理
+     */
+    ignore?: boolean;
+    /**
+     * 是否在表单中隐藏
+     */
+    hide?: boolean | ((scope: FormScope<PO, SO, PK, PV, SV> & {
+        getInitValue: () => PV;
+    }) => boolean);
+    /**
+     * 被关联配置
+     * 1. 不要配置当前表单项的key
+     * 2. 最好不要循环关联
+     * 3. 必须循环关联时，避免循环引用
+     */
+    beLink?: FormItemLinkConfig<PK, PV, any> | FormItemLinkConfig<PK, PV, any>[];
+    /**
+     * 额外一些配置
+     */
+    extra?: FormItemConfigExtra;
+}
+/** form配置 */
+export type FormItemConfigList<PO extends Record<string, any> = Record<string, any>, SO extends Record<string, any> = Record<string, any>> = FormItemConfig<PO, SO>[];
+/** 表单数据 */ export type FormModel<L> = L extends FormItemConfigList<infer PO, any> ? PO : Record<string, any>;
+/** 提取格式化原始对象 */
+export type ExtractFormStringifyRawFromObject<PO extends Record<string, any>, SO extends Record<string, any>> = {
+    [K in keyof PO | keyof SO]: K extends keyof SO ? SO[K] extends never ? never : SO[K] extends undefined ? K extends keyof PO ? PO[K] : never : SO[K] : K extends keyof PO ? PO[K] : never;
+};
+/** 表单序列化数据原始 */
+export type ExtractFormStringifyRawFromList<L> = L extends FormItemConfigList<infer PO, infer SO> ? PO extends Record<string, any> ? SO extends Record<string, any> ? ExtractFormStringifyFromObject<PO, SO> : Record<string, any> : Record<string, any> : Record<string, any>;
+/** 提取除never以外的属性值 */
+export type ExcludeNeverProperties<T> = {
+    [K in keyof T as T[K] extends never ? never : K]: T[K];
+};
+export type ExtractFormStringifyFromObject<PO extends Record<string, any>, SO extends Record<string, any>> = ExcludeNeverProperties<ExtractFormStringifyRawFromObject<PO, SO>>;
+/** 表单序列化数据 */
+export type ExtractFormStringifyFromList<L> = ExcludeNeverProperties<ExtractFormStringifyRawFromList<L>>;
+/** form作用域数据 */
+export interface FormScope<
+/** 解析的模型 */
+PO extends Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any>, 
+/** 解析的模型的key */
+PK extends Extract<keyof PO, string>, 
+/** 解析的模型的值 */
+PV extends PO[PK], 
+/** 需要格式化的模型的值 */
+SV extends PK extends keyof SO ? SO[PK] : PV> {
+    data: PO;
+    config: FormItemConfig<PO, SO, PK, PV, SV>;
+}
+/** FormMain expose类型 */
+export interface FormMainInstance {
+    validate: () => Promise<void>;
+    resetFields: () => void;
+    clearValidate: (key?: string) => void;
+}
+/** FormSearch expose类型 */
+export interface FormSearchInstance extends FormMainInstance {
+    /** 触发搜索 */
+    triggerSearch: () => void;
+    /** 触发重置 */
+    triggerReset: () => void;
+}
+/** FormItem props */
+export interface FormMainItemProps {
+    config: FormItemConfig<Record<string, any>, Record<string, any>>;
+    data: Record<string, any>;
+}
+/** FormMain props */
+export interface FormMainProps<PO extends Record<string, any>, SO extends Record<string, any>> {
+    list: FormItemConfigList<PO, SO>;
+    data: PO;
+    layout?: Partial<ColProps>;
+}
+/** FormSearch props */
+export interface FormSearchProps<PO extends Record<string, any>, SO extends Record<string, any>, SQ extends Record<string, any>> extends FormMainProps<PO, SO> {
+    labelPosition?: "right" | "left" | "top";
+    labelWidth?: string;
+    /** 静态参数(非表单 非分页参数) */
+    staticQuery?: SQ;
+}
+/** form item loading 信息 */
+export interface FormItemLoadingInfo {
+    key: string;
+    label: string;
+    message: string;
+}
+/** form item 加载状态信息 */
+export type FormItemLoadingChangeFunc = (data: {
+    key: string;
+    message?: string;
+}) => void;
+/** form tree 单项类型 */
+export interface FormTreeItem {
+    id: string | number;
+    label: string;
+    children?: FormTreeItem[];
+    disabled?: boolean;
+    [key: string]: any;
+}
+/** form单项表单提交类型 */
+export type FormItemSubmitType = "blur" | "change" | "enter";
+/** 表单搜索搜索类型 */
+export type FormSearchSearchType = "search" | "reset" | FormItemSubmitType;
+export type FormItemConfigSwiftOptionsCommon<PO extends Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any>> = Omit<FormItemConfig<PO, SO>, "rules"> & {
+    /** label */
+    /**
+     *  表单类型
+     * ----
+     *  input: 会补齐 extra.isInput = true 最终表现在组件会默认设置placeholder `请输入${label}`,同时如果设置了required 会自动添加一条校验规则 提示信息同 placeholder;
+     *
+     *  select: 会补齐 extra.isSelect = true 最终表现在组件会默认设置placeholder `请选择${label}`,同时如果设置了required 会自动添加一条校验规则 提示信息同 placeholder;
+     *  如果不设置此项 不会补齐 extra
+     */
+    type?: "input" | "select";
+};
+/** 表单配置项快捷生成类型 - 设置required */
+export interface FormItemConfigSwiftOptionsRequired<PO extends Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any>> extends FormItemConfigSwiftOptionsCommon<PO, SO> {
+    /**
+     * 是否必填
+     * -----
+     * 设置了此项 不能设置 rules, 如果校验规则只是验证必填 使用此选项更方便
+     */
+    required?: true;
+}
+/** 表单配置项快捷生成类型 - 设置rules */
+export interface FormItemConfigSwiftOptionsRules<PO extends Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any>> extends FormItemConfigSwiftOptionsCommon<PO, SO> {
+    /**
+     * 校验规则
+     * ---
+     * 设置了此项 不能直接设置 required, 如果校验规则特殊 或者 要基于数据值动态校验 请使用 rules
+     */
+    rules?: FormItemConfig["rules"];
+}
+/** 表单配置项快捷生成类型 */
+export type FormItemConfigSwiftOptions<PO extends Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any>> = FormItemConfigSwiftOptionsRequired<PO, SO> | FormItemConfigSwiftOptionsRules<PO, SO>;
+export {};

package/types/components/form/utils.d.ts

@@ -0,0 +1,49 @@
+import { FormItemConfig, FormItemConfigList, ExtractFormStringifyFromObject, FormItemConfigSwiftOptions } from './types';
+
+/**
+ * 生成表单数据
+ */
+export declare const generateFormData: <PO extends Record<string, any>, SO extends Record<string, any>>(list: FormItemConfigList<PO, SO>) => PO;
+/**
+ * 解析表单数据
+ */
+export declare const parseFormData: <PO extends Record<string, any>, SO extends Record<string, any>>(data: ExtractFormStringifyFromObject<PO, SO>, list: FormItemConfigList<PO, SO>) => PO;
+/**
+ * 序列化表单数据
+ */
+export declare const stringifyFormData: <PO extends Record<string, any>, SO extends Record<string, any>>(data: PO, list: FormItemConfigList<PO, SO>) => import('./types').ExcludeNeverProperties<import('./types').ExtractFormStringifyRawFromObject<PO, SO>>;
+/**
+ * 获取v-model语法糖配置
+ */
+export declare const getVModelSugar: <PO extends Record<string, any>, SO extends Record<string, any>, PK extends Extract<keyof PO, string>, MK extends string>({ modelValueKey, config, data, updateData, }: {
+    modelValueKey?: MK;
+    config: FormItemConfig<PO, SO>;
+    data: PO;
+    updateData?: (val: PO[PK]) => void;
+}) => { [P in MK]: PO[PK]; } & { [E in string as `onUpdate:${MK}`]: (val: PO[PK]) => void; };
+/** 获取placeholder */
+export declare const getPlaceholder: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>) => {
+    placeholder?: string;
+};
+/** 获取回车提交 */
+export declare const getEnterSubmit: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>, handler: () => void) => {
+    onKeyup: (e: KeyboardEvent) => void;
+} | undefined;
+/** 获取失去焦点提交 */
+export declare const getBlurSubmit: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>, handler: () => void) => {
+    onBlur: () => void;
+} | undefined;
+/** 获取变化提交 */
+export declare const getChangeSubmit: <PO extends Record<string, any>, SO extends Record<string, any>>(config: FormItemConfig<PO, SO>, handler: () => void) => {
+    onChange: () => void;
+} | undefined;
+/** form item 更改loading状态 */
+export declare const FORM_ITEM_CHANGE_LOADING: unique symbol;
+/** 设置输入类型组件 */
+export declare const setInputComponent: (components: any[]) => void;
+/** 设置选择类型组件 */
+export declare const setSelectComponent: (components: any[]) => void;
+/** 快捷配置表单项 */
+export declare const swiftFormItemConfig: <PO extends Record<string, any>, 
+/** 需要格式化的模型 */
+SO extends Record<string, any>>(options: FormItemConfigSwiftOptions<PO, SO>) => FormItemConfig<PO, SO>;

package/types/components/list-page/ListPage.vue.d.ts

@@ -0,0 +1,44 @@
+import { FormItemConfigList, FormSearchSearchType } from '../form';
+import { TableMainInstance } from '../table';
+import { ListPageInnerInjectInfo, ListPageInstance } from './types';
+
+declare const _default: <T extends Record<string, any>, PO extends Record<string, any>, SO extends Record<string, any>, SQ extends Record<string, any>, F extends Record<string, any>>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{} & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & (Partial<Pick<import('../form').FormSearchProps<PO, SO, {}>, "staticQuery">> & {
+        formSearchProps?: Partial<Omit<import('../form').FormSearchProps<PO, SO, {}>, "list" | "staticQuery">> | undefined;
+    } & Pick<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListPageInnerInjectInfo<PO, F>>, import('./types').TableMainRequiredKey> & Partial<Pick<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListPageInnerInjectInfo<PO, F>>, import('./types').TableMainOptionsKey>> & {
+        tableMainProps?: Partial<Omit<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListPageInnerInjectInfo<PO, F>>, import('./types').TableMainOptionsKey | import('./types').TableMainRewriteKey>> | undefined;
+    } & {
+        showOperation?: boolean;
+        list?: FormItemConfigList<PO, SO> | undefined;
+        api: (params: import('../table').TableApiParams<import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ>) => Promise<import('../table').TableApiResult<T>>;
+        query?: SQ | undefined;
+        injectInfo?: F | undefined;
+        beforeSearch?: ((data: import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>>, type: FormSearchSearchType) => import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>>) | undefined;
+        clearTableFilterOnReset?: boolean;
+    }), keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+    expose(exposed: import('vue').ShallowUnwrapRef<ListPageInstance<PO>>): void;
+    attrs: any;
+    slots: ReturnType<() => Partial<Record<`form-${Extract<keyof PO, string>}`, (_: any) => any>> & Partial<Record<NonNullable<"table-undefined" | `table-${Uppercase<string>}` | `table-${Extract<keyof T, string>}`>, (_: {
+        row: T;
+        column: import('../table').ElTableColumnProps<T, ListPageInnerInjectInfo<PO, F>>;
+        $index: number;
+        injectInfo: ListPageInnerInjectInfo<PO, F>;
+        exposeInfo: TableMainInstance;
+    }) => any>> & Partial<Record<NonNullable<"table-header-undefined" | `table-header-${Uppercase<string>}` | `table-header-${Extract<keyof T, string>}`>, (_: {
+        searchFormData: PO;
+        triggerSearch: (() => void) | undefined;
+        column: import('../table').ElTableColumnProps<T, ListPageInnerInjectInfo<PO, F>>;
+        $index: number;
+        injectInfo: ListPageInnerInjectInfo<PO, F>;
+        exposeInfo: TableMainInstance;
+    }) => any>> & {
+        operation?(_: {}): any;
+    }>;
+    emit: typeof __VLS_emit;
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/types/components/list-page/index.d.ts

@@ -0,0 +1,6 @@
+import { Plugin } from 'vue';
+import { default as ListPage } from './ListPage.vue';
+
+export * from './types';
+export { ListPage };
+export declare const listPageInstall: Plugin;

package/types/components/list-page/types.d.ts

@@ -0,0 +1,44 @@
+import { ExtractFormStringifyFromObject, ExtractFormStringifyFromList, FormItemConfigList, FormSearchInstance, FormSearchProps, FormSearchSearchType } from '../form';
+import { TableApiParams, TableApiResult, TableMainInstance, TableMainProps } from '../table';
+
+export type FormSearchOptionsKey = "staticQuery";
+export type FormSearchRewriteKey = "list";
+export type TableMainOptionsKey = "refine" | "refineReduceHeight";
+export type TableMainRequiredKey = "columns" | "rowKey";
+export type TableMainRewriteKey = "api" | "query" | "injectInfo";
+export type ListPageInnerInjectInfo<PO extends Record<string, any>, 
+/** 期望注入到表格列插槽上的额外内容 */
+F extends Record<string, any>> = Pick<ListPageInstance<PO>, "triggerReset" | "triggerSearch" | "update"> & F;
+export type ListPageProps<
+/** 行数据结构 */
+T extends Record<string, any>, 
+/** 表单标准结构模型 */
+PO extends Record<string, any>, 
+/** 表单需转换的部分结构模型 */
+SO extends Record<string, any>, 
+/** 静态参数 */
+SQ extends Record<string, any>, 
+/** 期望注入到表格列插槽上的额外内容 */
+F extends Record<string, any>> = Partial<Pick<FormSearchProps<PO, SO, {}>, FormSearchOptionsKey>> & {
+    formSearchProps?: Partial<Omit<FormSearchProps<PO, SO, {}>, FormSearchOptionsKey | FormSearchRewriteKey>>;
+} & Pick<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListPageInnerInjectInfo<PO, F>>, TableMainRequiredKey> & Partial<Pick<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListPageInnerInjectInfo<PO, F>>, TableMainOptionsKey>> & {
+    tableMainProps?: Partial<Omit<TableMainProps<T, ExtractFormStringifyFromObject<PO, SO> & SQ, ListPageInnerInjectInfo<PO, F>>, TableMainOptionsKey | TableMainOptionsKey | TableMainRewriteKey>>;
+} & {
+    /** 是否展示操作区 */
+    showOperation?: boolean;
+    list?: FormItemConfigList<PO, SO>;
+    /** api */
+    api: (params: TableApiParams<ExtractFormStringifyFromObject<PO, SO> & SQ>) => Promise<TableApiResult<T>>;
+    /** 静态参数 */
+    query?: SQ;
+    injectInfo?: F;
+    /** 搜索前的回调[同步] */
+    beforeSearch?: (data: ExtractFormStringifyFromObject<PO, SO>, type: FormSearchSearchType) => ExtractFormStringifyFromObject<PO, SO>;
+    /** 在点击搜索重置按钮时，是否同时调用清空表格表头过滤 */
+    clearTableFilterOnReset?: boolean;
+};
+export interface ListPageInstance<PO extends Record<string, any> = Record<string, any>> extends FormSearchInstance, TableMainInstance {
+    /** 更新表单数据 */
+    update: (key: Extract<keyof PO, string>, value: any) => void;
+}
+export type ListApiParams<L, SQ extends Record<string, any>> = TableApiParams<ExtractFormStringifyFromList<L> & SQ>;

package/types/components/menu/MenuItemSub.vue.d.ts

@@ -0,0 +1,19 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    menu: RouteMetaResolveRaw;
+    MenuItemSub: any;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    menu: RouteMetaResolveRaw;
+    MenuItemSub: any;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/types/components/menu/MenuTree.vue.d.ts

@@ -0,0 +1,28 @@
+import { RouteMetaResolveRaw } from '../../types';
+
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+    routerMode?: boolean;
+    collapse?: boolean;
+    autoClose?: boolean;
+}>>, {
+    open: (index: string) => void | undefined;
+    close: (index: string) => void | undefined;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    menus: RouteMetaResolveRaw[];
+    menuFlatList: RouteMetaResolveRaw[];
+    routerMode?: boolean;
+    collapse?: boolean;
+    autoClose?: boolean;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/types/components/menu/index.d.ts

@@ -0,0 +1,6 @@
+import { Plugin } from 'vue';
+import { default as MenuTree } from './MenuTree.vue';
+import { default as MenuItemSub } from './MenuItemSub.vue';
+
+export { MenuTree, MenuItemSub };
+export declare const menuInstall: Plugin;

package/types/components/misc/TriggerAutoImport.vue.d.ts

@@ -0,0 +1,11 @@
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/misc/index.d.ts

@@ -0,0 +1,5 @@
+import { Plugin } from 'vue';
+import { default as TriggerAutoImport } from './TriggerAutoImport.vue';
+
+export { TriggerAutoImport };
+export declare const miscInstall: Plugin;

package/types/components/modal/ConfirmModal.vue.d.ts

@@ -0,0 +1,107 @@
+declare function __VLS_template(): {
+    title?(_: {}): any;
+    default?(_: {}): any;
+    footer?(_: {
+        cancelHandler: () => Promise<void>;
+        confirmHandler: () => Promise<void>;
+        loading: boolean;
+    }): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    show: boolean;
+    showClose?: boolean;
+    onClose?: (status?: boolean) => void;
+    onCancel?: () => void | Promise<boolean | void>;
+    onConfirm?: () => void | Promise<boolean | void>;
+    title?: string | (() => VNode);
+    content?: string | (() => VNode);
+    cancelText?: string | (() => VNode);
+    confirmText?: string | (() => VNode);
+    /** 是否隐藏取消按钮 */
+    hiddenCancel?: boolean;
+    width?: number | string;
+    /** 反转按钮位置 */
+    reverse?: boolean;
+    /** 按下 ESC 是否关闭 */
+    closeOnPressEscape?: boolean;
+    /** 点击遮罩是否关闭 */
+    closeOnClickModal?: boolean;
+    /** 是否使用确认按钮loading */
+    useLoading?: boolean;
+}>, {
+    showClose: boolean;
+    cancelText: string;
+    confirmText: string;
+    hiddenCancel: boolean;
+    width: number;
+    reverse: boolean;
+    closeOnPressEscape: boolean;
+    closeOnClickModal: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:show": (value: boolean) => void;
+}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    show: boolean;
+    showClose?: boolean;
+    onClose?: (status?: boolean) => void;
+    onCancel?: () => void | Promise<boolean | void>;
+    onConfirm?: () => void | Promise<boolean | void>;
+    title?: string | (() => VNode);
+    content?: string | (() => VNode);
+    cancelText?: string | (() => VNode);
+    confirmText?: string | (() => VNode);
+    /** 是否隐藏取消按钮 */
+    hiddenCancel?: boolean;
+    width?: number | string;
+    /** 反转按钮位置 */
+    reverse?: boolean;
+    /** 按下 ESC 是否关闭 */
+    closeOnPressEscape?: boolean;
+    /** 点击遮罩是否关闭 */
+    closeOnClickModal?: boolean;
+    /** 是否使用确认按钮loading */
+    useLoading?: boolean;
+}>, {
+    showClose: boolean;
+    cancelText: string;
+    confirmText: string;
+    hiddenCancel: boolean;
+    width: number;
+    reverse: boolean;
+    closeOnPressEscape: boolean;
+    closeOnClickModal: boolean;
+}>>> & Readonly<{
+    "onUpdate:show"?: ((value: boolean) => any) | undefined;
+}>, {
+    width: number | string;
+    reverse: boolean;
+    showClose: boolean;
+    cancelText: string | (() => VNode);
+    confirmText: string | (() => VNode);
+    hiddenCancel: boolean;
+    closeOnPressEscape: boolean;
+    closeOnClickModal: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/types/components/modal/DetailModal.vue.d.ts

@@ -0,0 +1,23 @@
+import { ExtractFormStringifyFromObject } from '../form';
+import { DetailModalProps } from './types';
+
+declare const _default: <PO extends Record<string, any>, SO extends Record<string, any>>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{
+        readonly "onUpdate:show"?: ((value: boolean) => any) | undefined;
+        readonly onAfterAdd?: ((data: import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>>) => any) | undefined;
+        readonly onAfterEdit?: ((data: import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>>) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & DetailModalProps<PO, SO>, keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: ReturnType<() => {}>;
+    emit: {
+        (e: "update:show", value: boolean): void;
+        (e: "afterAdd" | "afterEdit", data: ExtractFormStringifyFromObject<PO, SO>): void;
+    };
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/types/components/modal/index.d.ts

@@ -0,0 +1,7 @@
+import { Plugin } from 'vue';
+import { default as ConfirmModal } from './ConfirmModal.vue';
+import { default as DetailModal } from './DetailModal.vue';
+
+export * from './types';
+export { ConfirmModal, DetailModal };
+export declare const modalInstall: Plugin;

package/types/components/modal/types.d.ts

@@ -0,0 +1,33 @@
+import { ExtractFormStringifyFromObject, FormItemConfigList, FormMainProps } from '../form';
+import { FormProps } from 'element-plus';
+
+/** 详情页类型 */
+export type DetailType = "add" | "edit" | "read";
+export interface DetailModalProps<
+/** 表单标准结构模型 */
+PO extends Record<string, any>, 
+/** 表单需转换的部分结构模型 */
+SO extends Record<string, any>> {
+    /** 表单数据 */
+    data: PO;
+    /** 表单配置 */
+    list: FormItemConfigList<PO, SO>;
+    /** 表单类型 */
+    type: DetailType;
+    /**
+     * 标题
+     * 最终表现为：新增[标题]、编辑[标题]
+     */
+    subTitle?: string;
+    show: boolean;
+    /** 新增api */
+    addApi?: (data: ExtractFormStringifyFromObject<PO, SO>) => Promise<any>;
+    /** 编辑api */
+    editApi?: (data: ExtractFormStringifyFromObject<PO, SO>) => Promise<any>;
+    /** 弹窗宽度 */
+    modalWidth?: number | string;
+    /** 表单整体布局 */
+    formLayout?: FormMainProps<PO, SO>["layout"];
+    /** elForm其他属性 */
+    formProps?: Partial<FormProps>;
+}