@clownlee/menu 1.0.0

package/README.md

@@ -0,0 +1,17 @@
+# @fly/menu
+
+菜单管理能力，提供微应用的菜单结构管理功能
+
+## 开发
+- `pnpm install`
+- `pnpm build`（库模式，产物位于 dist/，CSS 已内联）
+
+## 目录
+- src/ 源码
+- src/types/ 类型声明
+- src/styles/ 样式
+- .cursor/rules/ 规范
+
+## 规范
+- 依赖使用外部化（Vue/Element Plus/Pinia）
+- CSS 通过 vite-plugin-css-injected-by-js 内联

package/dist/app-menu/index.vue.d.ts

@@ -0,0 +1,82 @@
+interface MenuTreeModel {
+    menuId: string;
+    menuName?: string;
+    menuCode?: string;
+    menuPath?: string;
+    menuIcon?: string;
+    menuType?: string;
+    sortOrder?: number;
+    level?: number;
+    hasChildren?: boolean;
+    appId?: string;
+    appName?: string;
+    appIcon?: string;
+    appUri?: string;
+    appUrl?: string;
+    appApi?: string;
+    children?: MenuTreeModel[];
+}
+interface Props {
+    /** 菜单树数据 */
+    menuTree?: MenuTreeModel[];
+    /** 当前激活的菜单ID */
+    activeMenuId?: string;
+    /** 展开的一级菜单keys */
+    expandedFirstLevelKeys?: string[];
+    /** 用户角色 */
+    userRole?: string;
+    /** 是否显示通知图标 */
+    showNotification?: boolean;
+    /** 通知数量 */
+    notificationCount?: number;
+}
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    menuTree: () => never[];
+    activeMenuId: string;
+    expandedFirstLevelKeys: () => never[];
+    userRole: string;
+    showNotification: boolean;
+    notificationCount: number;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "first-level-click": (payload: {
+        menu: MenuTreeModel;
+    }) => void;
+    "all-apps-click": () => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    menuTree: () => never[];
+    activeMenuId: string;
+    expandedFirstLevelKeys: () => never[];
+    userRole: string;
+    showNotification: boolean;
+    notificationCount: number;
+}>>> & Readonly<{
+    "onFirst-level-click"?: ((payload: {
+        menu: MenuTreeModel;
+    }) => any) | undefined;
+    "onAll-apps-click"?: (() => any) | undefined;
+}>, {
+    menuTree: MenuTreeModel[];
+    activeMenuId: string;
+    expandedFirstLevelKeys: string[];
+    userRole: string;
+    showNotification: boolean;
+    notificationCount: number;
+}, {}, {}, {}, 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/avatar/index.vue.d.ts

@@ -0,0 +1,98 @@
+import { Component } from 'vue';
+
+type ObjectFit = 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
+interface Props {
+    /** 头像图片的源地址 */
+    src?: string;
+    /** 头像大小，支持 number 或 'large' | 'default' | 'small' */
+    size?: number | 'large' | 'default' | 'small';
+    /** 头像形状，'circle' 圆形或 'square' 方形 */
+    shape?: 'circle' | 'square';
+    /** 设置头像的图标类型，具体参考 Icon 组件 */
+    icon?: string | Component;
+    /** 当展示类型为图片时，设置图片如何适应容器，与 object-fit 属性一致 */
+    fit?: ObjectFit;
+    /** 图片 Avatar 的原生 alt 属性 */
+    alt?: string;
+    /** 文字内容，当没有 src 和 icon 时显示 */
+    text?: string;
+    /** 是否显示 Popover 菜单 */
+    showPopover?: boolean;
+    /** Popover 触发方式 */
+    trigger?: 'click' | 'hover' | 'focus';
+    /** Popover 宽度 */
+    popoverWidth?: number;
+    /** 用户姓名 */
+    userName?: string;
+    /** 租户编码 */
+    tenantCode?: string;
+    /** 是否显示个人中心菜单项 */
+    showProfile?: boolean;
+    /** 是否显示设置菜单项 */
+    showSettings?: boolean;
+}
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    size: string;
+    shape: string;
+    fit: string;
+    showPopover: boolean;
+    trigger: string;
+    popoverWidth: number;
+    showProfile: boolean;
+    showSettings: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    error: () => void;
+    profile: () => void;
+    settings: () => void;
+    logout: () => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<Props>, {
+    size: string;
+    shape: string;
+    fit: string;
+    showPopover: boolean;
+    trigger: string;
+    popoverWidth: number;
+    showProfile: boolean;
+    showSettings: boolean;
+}>>> & Readonly<{
+    onError?: (() => any) | undefined;
+    onProfile?: (() => any) | undefined;
+    onSettings?: (() => any) | undefined;
+    onLogout?: (() => any) | undefined;
+}>, {
+    size: number | "large" | "default" | "small";
+    shape: "circle" | "square";
+    fit: ObjectFit;
+    showPopover: boolean;
+    trigger: "click" | "hover" | "focus";
+    popoverWidth: number;
+    showProfile: boolean;
+    showSettings: 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/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { default as Avatar } from './avatar/index.vue';
+import { default as AppMenu } from './app-menu/index.vue';
+import { default as RouteMenu } from './route-menu/index.vue';
+
+export { Avatar, AppMenu, RouteMenu };