@wapri/element-pro 3.0.0

package/dist/Sidebar/types.d.ts

@@ -0,0 +1,154 @@
+import { Component, VNodeChild } from 'vue';
+
+/** 侧栏菜单元信息 */
+export interface SidebarMenuMeta {
+    /** 菜单标题 */
+    title?: string;
+    /** 菜单图标，支持 Element Plus 图标名（`Setting`、`setting`、`el-icon-setting`）或由 `renderIcon` 处理的自定义图标名 */
+    icon?: string;
+    /** 需要高亮的菜单路径，用于详情页等隐藏路由 */
+    activeMenu?: string;
+}
+/** 侧栏菜单项，兼容若依风格的动态路由结构 */
+export interface SidebarMenuItem {
+    /** 菜单路径，支持绝对路径与相对父级的相对路径 */
+    path: string;
+    /** 是否在侧栏中隐藏 */
+    hidden?: boolean;
+    /**
+     * 是否始终渲染为父级菜单，即使只有一个可见子菜单
+     * @default true
+     * */
+    alwaysShow?: boolean;
+    /** 是否没有可显示的子菜单 */
+    noShowingChildren?: boolean;
+    /** JSON 字符串形式的查询参数，如 `{"id":"1"}` */
+    query?: string;
+    /** 子菜单 */
+    children?: SidebarMenuItem[];
+    /** 菜单元信息 */
+    meta?: SidebarMenuMeta;
+}
+/** 菜单跳转目标 */
+export type SidebarLinkTarget = string | {
+    path: string;
+    query?: Record<string, unknown>;
+};
+/** 侧栏导航模式：`grouped` 双列分组导航，`classic` 经典 el-menu 树形导航 */
+export type SidebarMode = 'classic' | 'grouped';
+/** 侧栏主题：`dark` 深色主题，`light` 浅色主题 */
+export type SidebarTheme = 'light' | 'dark';
+/** Logo 门户标识：`merchant` 后台，`platform` 平台 */
+export type SidebarPortal = 'merchant' | 'platform';
+/**
+ * 侧栏主题变量，会被映射为组件根节点的 CSS 变量。
+ * 不传时使用内置默认值，也可在外部通过同名 CSS 变量覆盖。
+ */
+export interface SidebarVariables {
+    /** 深色主题菜单文字颜色 */
+    menuColor?: string;
+    /** 浅色主题菜单文字颜色 */
+    menuLightColor?: string;
+    /** 深色主题激活态文字颜色 */
+    menuColorActive?: string;
+    /** 深色主题菜单背景色 */
+    menuBackground?: string;
+    /** 浅色主题菜单背景色 */
+    menuLightBackground?: string;
+    /** 深色主题子菜单背景色 */
+    subMenuBackground?: string;
+    /** 深色主题子菜单悬浮背景色 */
+    subMenuHover?: string;
+    /** Logo 主标题颜色 */
+    logoTitleColor?: string;
+    /** Logo 浅色主题主标题颜色 */
+    logoLightTitleColor?: string;
+    /** 激活态主色 */
+    activeColor?: string;
+    /** 浅色主题激活态背景色 */
+    activeColorLight?: string;
+    /** 深色主题激活态背景色 */
+    activeColorDarkBg?: string;
+    /** 侧栏宽度 */
+    width?: string;
+    /** 分组导航展开态宽度 */
+    groupedWidth?: string;
+    /** 折叠态宽度 */
+    collapsedWidth?: string;
+}
+/** 自定义图标渲染函数，入参为菜单元信息中的 `icon` */
+export type SidebarIconRender = (icon: string) => VNodeChild;
+/** Sidebar 组件 props */
+export interface SidebarProps {
+    /** 侧栏菜单数据，通常为已按权限过滤后的一级菜单列表 */
+    menus?: SidebarMenuItem[];
+    /** 当前激活菜单路径，通常由宿主传入 `route.path`，并优先使用 `route.meta.activeMenu` */
+    activeMenu?: string;
+    /** 是否折叠侧栏 */
+    collapse?: boolean;
+    /** 导航模式，默认 `classic` */
+    mode?: SidebarMode;
+    /** 侧栏主题，默认 `dark`；`grouped` 模式下固定使用浅色主题 */
+    theme?: SidebarTheme;
+    /** 主题变量 */
+    variables?: SidebarVariables;
+    /** 是否显示 Logo 区域 */
+    showLogo?: boolean;
+    /** Logo 图片地址 */
+    logo?: string;
+    /** Logo 主标题，未配置 `logo` 时折叠态会直接展示该标题 */
+    title?: string;
+    /** Logo 副标题，即门户名称，不传则不渲染门户标识 */
+    subtitle?: string;
+    /** 门户标识类型，决定副标题的配色 */
+    portal?: SidebarPortal;
+    /** Logo 点击跳转目标，默认 `/index` */
+    logoTo?: SidebarLinkTarget;
+    /** 内部链接使用的组件，默认 `router-link`；传入自定义组件即可完全接管链接渲染 */
+    linkComponent?: string | Component;
+    /** 自定义图标渲染函数，命中 Element Plus 图标名时不会调用 */
+    renderIcon?: SidebarIconRender;
+}
+/** 菜单链接渲染所需信息 */
+export interface SidebarLinkInfo {
+    /** 跳转目标 */
+    to: SidebarLinkTarget;
+    /** 是否为外部链接 */
+    isExternal: boolean;
+    /** 是否为当前激活项 */
+    active: boolean;
+    /** 对应的菜单项 */
+    item?: SidebarMenuItem;
+}
+/** SidebarLogo 组件 props */
+export interface SidebarLogoProps {
+    /** 是否折叠 */
+    collapse?: boolean;
+    /** 是否处于分组导航模式 */
+    grouped?: boolean;
+    /** Logo 图片地址 */
+    logo?: string;
+    /** 主标题 */
+    title?: string;
+    /** 副标题（门户名称） */
+    subtitle?: string;
+    /** 门户标识类型 */
+    portal?: SidebarPortal;
+    /** 点击跳转目标 */
+    to?: SidebarLinkTarget;
+    /** 内部链接使用的组件 */
+    linkComponent?: string | Component;
+}
+/** SidebarItem 组件 props */
+export interface SidebarItemProps {
+    /** 菜单项 */
+    item: SidebarMenuItem;
+    /** 是否为嵌套子菜单 */
+    isNest?: boolean;
+    /** 父级路径 */
+    basePath?: string;
+    /** 自定义图标渲染函数 */
+    renderIcon?: SidebarIconRender;
+    /** 内部链接使用的组件 */
+    linkComponent?: string | Component;
+}

package/dist/Sidebar/utils.d.ts

@@ -0,0 +1,16 @@
+import { SidebarLinkTarget, SidebarMenuItem } from './types';
+
+/** 判断路径是否为外部链接（http/https/mailto/tel） */
+export declare function isExternalPath(path: unknown): boolean;
+/** 去掉路径中重复的斜杠与结尾斜杠 */
+export declare function normalizePath(path: string): string;
+/** 基于父级路径拼接出完整路由路径，外部链接原样返回 */
+export declare function resolveMenuPath(basePath: string | undefined, routePath: string | undefined): string;
+/** 解析菜单项中 JSON 字符串形式的 query，解析失败时返回 undefined */
+export declare function parseMenuQuery(query: string | undefined): Record<string, unknown> | undefined;
+/** 拼接菜单跳转目标，带 query 时返回对象形式 */
+export declare function createLinkTarget(basePath: string | undefined, routePath: string | undefined, query?: string): SidebarLinkTarget;
+/** 取跳转目标中的路径字符串 */
+export declare function getLinkPath(target: SidebarLinkTarget): string;
+/** 过滤掉隐藏菜单，并按路径、标题去重，避免后端重复菜单导致侧栏出现重复项 */
+export declare function dedupeMenus(menus: SidebarMenuItem[] | undefined): SidebarMenuItem[];

package/dist/SvgIcon/iconfont.d.ts

@@ -0,0 +1,11 @@
+export interface IconfontSymbol {
+    content: string;
+    viewBox: string | undefined;
+}
+/**
+ * 在浏览器中按需加载图标集脚本（例如阿里 Iconfont 导出的 symbol 集合）。
+ *
+ * 图标源由调用方传入（`SvgIcon` 的 `src` 或 `ConfigProvider` 的 `iconfont`），库内不内置任何图标地址。
+ */
+export declare function loadIconfont(url: string): Promise<void>;
+export declare function getIconfontSymbol(id: string): IconfontSymbol | undefined;

package/dist/SvgIcon/index.d.ts

@@ -0,0 +1,35 @@
+export declare const SvgIcon: import('../utils/install').SFCWithInstall<import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    size: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    name: {
+        type: import('vue').PropType<string>;
+        required: true;
+    };
+    src: {
+        type: import('vue').PropType<string>;
+    };
+    color: {
+        type: import('vue').PropType<string | string[]>;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    size: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    name: {
+        type: import('vue').PropType<string>;
+        required: true;
+    };
+    src: {
+        type: import('vue').PropType<string>;
+    };
+    color: {
+        type: import('vue').PropType<string | string[]>;
+    };
+}>> & Readonly<{}>, {
+    size: number | string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>> & Record<string, unknown>;
+export type { SvgIconProps } from './index.vue';
+export default SvgIcon;

package/dist/SvgIcon/index.vue.d.ts

@@ -0,0 +1,38 @@
+export interface SvgIconProps {
+    /** Iconfont symbol 名称，可传 `card` 或完整的 `icon-card`。 */
+    name: string;
+    /** 图标尺寸；数字单位为 px。 */
+    size?: number | string;
+    /** 图标颜色；数组按 SVG path 顺序应用，最后一项会复用到其余 path。 */
+    color?: string | string[];
+    /**
+     * 图标集脚本地址。不传时使用 `ConfigProvider` 注入的 `iconfont`；
+     * 两者都没有时只读取页面内已存在的 `<symbol>`，不发起任何网络请求。
+     */
+    src?: string;
+}
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<SvgIconProps>, {
+    size: string;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<SvgIconProps>, {
+    size: string;
+}>>> & Readonly<{}>, {
+    size: number | string;
+}, {}, {}, {}, 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;
+    };
+};
+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];
+} & {};

package/dist/TagSelector/index.d.ts

@@ -0,0 +1,51 @@
+export declare const TagSelector: import('../utils/install').SFCWithInstall<import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    modelValue: {
+        type: import('vue').PropType<import('./types').TagSelectorValue | import('./types').TagSelectorValue[]>;
+    };
+    multiple: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    options: {
+        type: import('vue').PropType<import('./types').TagSelectorOption[]>;
+        required: true;
+    };
+    showAll: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    allText: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: import('./types').TagSelectorValue | import('./types').TagSelectorValue[] | undefined) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    modelValue: {
+        type: import('vue').PropType<import('./types').TagSelectorValue | import('./types').TagSelectorValue[]>;
+    };
+    multiple: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    options: {
+        type: import('vue').PropType<import('./types').TagSelectorOption[]>;
+        required: true;
+    };
+    showAll: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    allText: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+}>> & Readonly<{
+    "onUpdate:modelValue"?: ((value: import('./types').TagSelectorValue | import('./types').TagSelectorValue[] | undefined) => any) | undefined;
+}>, {
+    multiple: boolean;
+    showAll: boolean;
+    allText: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>> & Record<string, unknown>;
+export * from './types';
+export default TagSelector;

package/dist/TagSelector/index.vue.d.ts

@@ -0,0 +1,49 @@
+import { TagSelectorOption, TagSelectorValue } from './types';
+
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    modelValue?: TagSelectorValue | TagSelectorValue[];
+    options: TagSelectorOption[];
+    multiple?: boolean;
+    showAll?: boolean;
+    allText?: string;
+}>, {
+    multiple: boolean;
+    showAll: boolean;
+    allText: string;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: TagSelectorValue | TagSelectorValue[] | undefined) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<{
+    modelValue?: TagSelectorValue | TagSelectorValue[];
+    options: TagSelectorOption[];
+    multiple?: boolean;
+    showAll?: boolean;
+    allText?: string;
+}>, {
+    multiple: boolean;
+    showAll: boolean;
+    allText: string;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((value: TagSelectorValue | TagSelectorValue[] | undefined) => any) | undefined;
+}>, {
+    multiple: boolean;
+    showAll: boolean;
+    allText: string;
+}, {}, {}, {}, 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;
+    };
+};
+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];
+} & {};

package/dist/TagSelector/types.d.ts

@@ -0,0 +1,6 @@
+export type TagSelectorValue = string | number;
+export interface TagSelectorOption {
+    text: string;
+    value: TagSelectorValue;
+    disabled?: boolean;
+}

package/dist/VH100/index.d.ts

@@ -0,0 +1,40 @@
+export declare const VH100: import('../utils/install').SFCWithInstall<{
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        stype: {
+            type: import('vue').PropType<import('vue').CSSProperties>;
+        };
+        class: {
+            type: import('vue').PropType<string>;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        stype: {
+            type: import('vue').PropType<import('vue').CSSProperties>;
+        };
+        class: {
+            type: import('vue').PropType<string>;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    stype: {
+        type: import('vue').PropType<import('vue').CSSProperties>;
+    };
+    class: {
+        type: import('vue').PropType<string>;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+    };
+})> & Record<string, unknown>;
+export type { VH100Props } from './index.vue';
+export default VH100;

package/dist/VH100/index.vue.d.ts

@@ -0,0 +1,26 @@
+import { CSSProperties } from 'vue';
+
+export type VH100Props = {
+    stype?: CSSProperties;
+    class?: string;
+};
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<VH100Props>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<VH100Props>>> & Readonly<{}>, {}, {}, {}, {}, 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_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/constant/index.d.ts

@@ -0,0 +1 @@
+export declare const defaultPrefix = "wa-ui";

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { ModalForm } from './ModalForm';
+import { DrawerForm } from './DrawerForm';
+import { Ellipsis } from './Ellipsis';
+import { App } from 'vue';
+import { DateQuickSelect } from './DateQuickSelect';
+import { ProTable } from './ProTable';
+import { TagSelector } from './TagSelector';
+import { VH100 } from './VH100';
+import { ConfigProvider } from './ConfigProvider';
+import { SvgIcon } from './SvgIcon';
+import { Layout } from './Layout';
+import { MainContent } from './MainContent';
+import { ShareButton } from './ShareButton';
+import { Sidebar } from './Sidebar';
+import { CropperUpload } from './CropperUpload';
+import { version } from '../package.json';
+
+export * from './ProTable';
+export { type DateQuickSelectSelection, type DateQuickSelectValue, type DateQuickSelectValueType, } from './DateQuickSelect';
+export * from './TagSelector';
+export * from './VH100';
+export * from './ConfigProvider';
+export * from './SvgIcon';
+export * from './CheckCard';
+export * from './Ellipsis';
+export * from './Layout';
+export * from './MainContent';
+export * from './ShareButton';
+export * from './Sidebar';
+export * from './CropperUpload';
+export { ConfigProvider, SvgIcon, ProTable, VH100, ModalForm, DrawerForm, Ellipsis, DateQuickSelect, TagSelector, Sidebar, MainContent, Layout, ShareButton, CropperUpload, };
+export type { ModalFormProps, DrawerFormProps, OverlayFormProps, OverlayFormAction } from './shared/overlayForm/types';
+export { version };
+declare const _default: {
+    install: (app: App) => void;
+    version: string;
+};
+export default _default;