@me-framework/me-ui-antdv-next 0.0.36 → 0.0.39

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

@@ -1,5 +1,5 @@
 import { MeMenuItem, MeMenuProps } from './types';
-declare var __VLS_1: {}, __VLS_13: {}, __VLS_63: {
+declare var __VLS_1: {}, __VLS_13: {}, __VLS_44: {
     collapsed: boolean;
 };
 type __VLS_Slots = {} & {
@@ -7,7 +7,7 @@ type __VLS_Slots = {} & {
 } & {
     footer?: (props: typeof __VLS_13) => any;
 } & {
-    'right-toggle'?: (props: typeof __VLS_63) => any;
+    'right-toggle'?: (props: typeof __VLS_44) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<MeMenuProps, {
     setBadge: (key: string, badge: string | number | boolean, color?: string) => void;
@@ -41,6 +41,8 @@ declare const __VLS_base: import('vue').DefineComponent<MeMenuProps, {
     rightWidth: string | number;
     hideDisabled: boolean;
     showHidden: boolean;
+    parentField: string;
+    childrenField: string;
     showRightToggle: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/menu/types.d.ts

@@ -229,7 +229,15 @@ export interface MeMenuProps {
      */
     keyField?: string;
     /**
-     * 是否折叠右侧子菜单（仅显示左侧一级菜单），点击已激活的一级菜单项可切换，支持 v-model
+     * 父级菜单 ID 的字段名，默认 'parentId'（一级菜单通过该字段值为 '0' 识别）
+     */
+    parentField?: string;
+    /**
+     * 子菜单数组的字段名，默认 'children'
+     */
+    childrenField?: string;
+    /**
+     * 是否折叠右侧子菜单（仅显示左侧一级菜单），支持 v-model
      */
     rightCollapsed?: boolean;
     /**

package/dist/menu/useMenu.d.ts

@@ -0,0 +1,56 @@
+import { MeMenuItem } from './types';
+/**
+ * 徽标颜色映射：将预设颜色名转换为 antd Badge 可用的颜色值
+ */
+export declare const resolveBadgeColor: (color?: string) => string | undefined;
+export interface UseMenuOptions {
+    keyField: string;
+    childrenField: string;
+    hideDisabled: boolean;
+    showHidden: boolean;
+}
+/**
+ * provide 给子组件的菜单上下文
+ * 包含绑定好 options 的工具函数，子组件直接调用无需传参
+ */
+export interface MenuContext {
+    keyField: string;
+    childrenField: string;
+    hideDisabled: boolean;
+    showHidden: boolean;
+    selectedId: string;
+    expandedSections: Set<string>;
+    getItemKey: (item: MeMenuItem) => string;
+    getVisibleChildren: (item: MeMenuItem) => MeMenuItem[];
+    resolveBadgeColor: (color?: string) => string | undefined;
+}
+/** 注入 key */
+export declare const menuContextKey: unique symbol;
+/**
+ * 获取菜单项的唯一标识值
+ */
+export declare const getItemKey: (item: MeMenuItem, keyField: string) => string;
+/**
+ * 获取菜单项的子菜单数组
+ */
+export declare const getChildren: (item: MeMenuItem | null | undefined, childrenField: string) => MeMenuItem[];
+/**
+ * 判断菜单项是否可见
+ */
+export declare const isItemVisible: (item: MeMenuItem, options: UseMenuOptions) => boolean;
+/**
+ * 获取一个菜单项下的所有可见子菜单（过滤 + 排序）
+ */
+export declare const getVisibleChildren: (item: MeMenuItem, options: UseMenuOptions) => MeMenuItem[];
+/**
+ * 递归查找菜单项
+ */
+export declare const findItemByKey: (items: MeMenuItem[], key: string, options: UseMenuOptions) => MeMenuItem | null;
+/**
+ * 判断菜单项是否是可选中的叶子项（非分组、无可见子菜单）
+ */
+export declare const isLeafItem: (item: MeMenuItem, options: UseMenuOptions) => boolean;
+/**
+ * 获取指定项及其所有后代中的第一个叶子项
+ */
+export declare const findFirstLeafUnder: (item: MeMenuItem, options: UseMenuOptions) => MeMenuItem | null;