@me-framework/me-ui-antdv-next 0.0.9 → 0.0.10

package/dist/components/nav/composables/useNavDrag.d.ts

@@ -0,0 +1,24 @@
+interface DragScrollOptions {
+    canScroll: () => boolean;
+    translateX: {
+        value: number;
+    };
+    clampTranslateX: () => void;
+    updateArrowVisibility: () => void;
+}
+/**
+ * 拖动滚动 + 惯性滚动
+ * - 鼠标拖动
+ * - 触屏滑动
+ * - 惯性滚动（松手后继续滑行）
+ */
+export declare function useNavDrag(options: DragScrollOptions): {
+    isDragging: import('vue').Ref<boolean, boolean>;
+    handleDragStart: (e: MouseEvent) => void;
+    handleTouchStart: (e: TouchEvent) => void;
+    setDragRefs: (scrollEl: HTMLElement | null, listEl: HTMLElement | null) => void;
+    getHasDragged: () => boolean;
+    resetHasDragged: () => void;
+    stopMomentum: () => void;
+};
+export {};

package/dist/components/nav/composables/useNavScroll.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 导航滚动核心逻辑
+ * - 水平滚动位移管理
+ * - 左右箭头显示控制
+ * - 边界限制
+ */
+export declare function useNavScroll(scrollRef: {
+    value: HTMLElement | null;
+}, listRef: {
+    value: HTMLElement | null;
+}): {
+    translateX: import('vue').Ref<number, number>;
+    showLeftArrow: import('vue').Ref<boolean, boolean>;
+    showRightArrow: import('vue').Ref<boolean, boolean>;
+    isSmooth: import('vue').Ref<boolean, boolean>;
+    isScrollable: import('vue').Ref<boolean, boolean>;
+    withSmooth: (action: () => void) => void;
+    updateArrowVisibility: () => void;
+    clampTranslateX: () => void;
+    scrollLeft: () => void;
+    scrollRight: () => void;
+    canScroll: () => boolean;
+};

package/dist/components/nav/index.vue.d.ts

@@ -1,31 +1,75 @@
-import { MeNavProps, MeNavTabItemData } from './types';
-declare var __VLS_1: {}, __VLS_16: {
+import { MeNavProps, MeNavTabItemData, MeNavMenuItem, MeNavBuiltinMenuItem } from './types';
+declare var __VLS_1: {}, __VLS_8: {}, __VLS_10: {
     item: MeNavTabItemData;
-}, __VLS_38: {};
+    index: number;
+    active: boolean;
+    close: () => Promise<void>;
+}, __VLS_12: {
+    item: MeNavTabItemData;
+}, __VLS_35: {
+    item: MeNavTabItemData;
+}, __VLS_47: {};
 type __VLS_Slots = {} & {
     left?: (props: typeof __VLS_1) => any;
 } & {
-    icon?: (props: typeof __VLS_16) => any;
+    empty?: (props: typeof __VLS_8) => any;
+} & {
+    tab?: (props: typeof __VLS_10) => any;
+} & {
+    icon?: (props: typeof __VLS_12) => any;
+} & {
+    'close-icon'?: (props: typeof __VLS_35) => any;
 } & {
-    right?: (props: typeof __VLS_38) => any;
+    right?: (props: typeof __VLS_47) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<MeNavProps, {
-    scrollToTab: (key?: string) => void;
+    scrollToTab: (name?: string) => void;
+    scrollTo: (name?: string) => void;
+    scrollToStart: () => void;
+    scrollToEnd: () => void;
+    activeItem: import('vue').ComputedRef<MeNavTabItemData | undefined>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:modelValue": (value: string) => any;
-    "tab-change": (value: string) => any;
-    "tab-remove": (value: string) => any;
+    scroll: (translateX: number) => any;
+    contextmenu: (payload: import('./types').MeNavContextMenuPayload) => any;
+    refresh: (payload: import('./types').MeNavBuiltinMenuPayload) => any;
+    "close-current": (payload: import('./types').MeNavBuiltinMenuPayload) => any;
+    "close-others": (payload: import('./types').MeNavBuiltinMenuPayload) => any;
+    "close-left": (payload: import('./types').MeNavBuiltinMenuPayload) => any;
+    "close-right": (payload: import('./types').MeNavBuiltinMenuPayload) => any;
+    "close-all": (payload: import('./types').MeNavBuiltinMenuPayload) => any;
+    "tab-change": (payload: import('./types').MeNavTabChangePayload) => any;
+    "tab-remove": (payload: import('./types').MeNavTabRemovePayload) => any;
+    "toggle-lock": (payload: import('./types').MeNavToggleLockPayload) => any;
 }, string, import('vue').PublicProps, Readonly<MeNavProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-    "onTab-change"?: ((value: string) => any) | undefined;
-    "onTab-remove"?: ((value: string) => any) | undefined;
+    onScroll?: ((translateX: number) => any) | undefined;
+    onContextmenu?: ((payload: import('./types').MeNavContextMenuPayload) => any) | undefined;
+    onRefresh?: ((payload: import('./types').MeNavBuiltinMenuPayload) => any) | undefined;
+    "onClose-current"?: ((payload: import('./types').MeNavBuiltinMenuPayload) => any) | undefined;
+    "onClose-others"?: ((payload: import('./types').MeNavBuiltinMenuPayload) => any) | undefined;
+    "onClose-left"?: ((payload: import('./types').MeNavBuiltinMenuPayload) => any) | undefined;
+    "onClose-right"?: ((payload: import('./types').MeNavBuiltinMenuPayload) => any) | undefined;
+    "onClose-all"?: ((payload: import('./types').MeNavBuiltinMenuPayload) => any) | undefined;
+    "onTab-change"?: ((payload: import('./types').MeNavTabChangePayload) => any) | undefined;
+    "onTab-remove"?: ((payload: import('./types').MeNavTabRemovePayload) => any) | undefined;
+    "onToggle-lock"?: ((payload: import('./types').MeNavToggleLockPayload) => any) | undefined;
 }>, {
     modelValue: string;
     width: number | string;
+    keyboard: boolean;
+    closable: boolean;
     tabList: MeNavTabItemData[];
-    menuHandle: (item: MeNavTabItemData, index: number) => import('./types').MeNavMenuItem[];
+    contextMenu: MeNavMenuItem[] | ((item: MeNavTabItemData, index: number) => MeNavMenuItem[]);
+    menuHandle: (item: MeNavTabItemData, index: number) => MeNavMenuItem[];
     tabProps: import('./types').MeNavTabProps;
     scrollTargetOffset: number;
+    showLockMenu: boolean;
+    titleMaxWidth: number | string;
+    activeAfterRemove: import('./types').MeNavActiveAfterRemove;
+    builtinMenu: MeNavBuiltinMenuItem[];
+    beforeClose: (item: MeNavTabItemData, index: number) => boolean | Promise<boolean>;
+    edgeFade: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/nav/types.d.ts

@@ -18,11 +18,14 @@ export interface MeNavTabItem {
 }
 /** Tab 属性映射配置，用于自定义数据字段名 */
 export interface MeNavTabProps {
-    /** 唯一标识字段名，默认 'path' */
+    /** 唯一标识字段名（同时用作激活匹配），默认 'path' */
     key?: string;
     /** 标签显示字段名，默认 'title' */
     label?: string;
-    /** 名称字段名，默认 'path' */
+    /**
+     * 名称字段名（已弃用，请用 key），默认 'path'
+     * @deprecated 与 key 含义相同，将在后续版本移除
+     */
     name?: string;
     /** 是否首页字段名，默认 'isHome' */
     isHome?: string;
@@ -37,15 +40,19 @@ export type MeNavTabItemData = Record<string, any>;
 export interface MeNavMenuItem {
     /** 菜单项标签 */
     label: string;
-    /** 菜单项图标（Lucide 图标名称） */
-    icon?: string;
+    /** 菜单项图标（Lucide 图标名称 或 自定义组件） */
+    icon?: string | Component;
     /** 是否禁用 */
     disabled?: boolean;
-    /** 是否显示分割线 */
+    /** 菜单项上方是否显示分割线 */
     divided?: boolean;
     /** 点击回调 */
     onClick?: () => void;
 }
+/** 内置菜单项类型 */
+export type MeNavBuiltinMenuItem = 'refresh' | 'close-current' | 'close-others' | 'close-left' | 'close-right' | 'close-all';
+/** 关闭 Tab 后激活策略 */
+export type MeNavActiveAfterRemove = 'prev' | 'next' | 'none';
 /** MeNav 组件 Props */
 export interface MeNavProps {
     /**
@@ -53,10 +60,14 @@ export interface MeNavProps {
      */
     tabList: MeNavTabItemData[];
     /**
-     * 右键菜单配置函数，返回菜单项数组
-     * @param item - 当前 Tab 项数据
-     * @param index - 当前 Tab 索引
-     * @returns 右键菜单项数组
+     * 右键菜单配置，支持数组（静态菜单）或函数（动态菜单）
+     * - 数组：直接传入菜单项列表
+     * - 函数：接收当前 Tab 数据和索引，返回菜单项列表
+     */
+    contextMenu?: MeNavMenuItem[] | ((item: MeNavTabItemData, index: number) => MeNavMenuItem[]);
+    /**
+     * 已弃用，请使用 contextMenu
+     * @deprecated 请使用 contextMenu
      */
     menuHandle?: (item: MeNavTabItemData, index: number) => MeNavMenuItem[];
     /**
@@ -79,24 +90,135 @@ export interface MeNavProps {
      * @default 0.1
      */
     scrollTargetOffset?: number;
-}
-/** MeNav 组件 Emits */
-export interface MeNavEmits {
     /**
-     * Tab 切换时触发
-     * @param value - 当前激活的 Tab name
+     * 是否显示内置的锁定/解锁右键菜单项
+     * @default true
      */
-    (e: 'update:modelValue', value: string): void;
+    showLockMenu?: boolean;
+    /**
+     * Tab 标题最大宽度，超出显示省略号 + tooltip
+     * - 数字：像素值
+     * - 字符串：如 '120px' / '10em'
+     * @default undefined
+     */
+    titleMaxWidth?: number | string;
+    /**
+     * 是否允许通过键盘方向键切换 Tab
+     * @default true
+     */
+    keyboard?: boolean;
+    /**
+     * 是否允许关闭 Tab（全局总开关）
+     * - 设为 false 则所有 Tab 都不可关闭，lock / isHome 不受影响
+     * @default true
+     */
+    closable?: boolean;
+    /**
+     * 关闭当前激活 Tab 后，激活哪一个
+     * - `'prev'` — 激活左边的 Tab
+     * - `'next'` — 激活右边的 Tab
+     * - `'none'` — 不自动切换，由父组件自行处理
+     * @default 'prev'
+     */
+    activeAfterRemove?: MeNavActiveAfterRemove;
+    /**
+     * 内置菜单项，快速开启常用右键菜单
+     * - `'refresh'` — 刷新当前
+     * - `'close-current'` — 关闭当前
+     * - `'close-others'` — 关闭其他
+     * - `'close-left'` — 关闭左侧
+     * - `'close-right'` — 关闭右侧
+     * - `'close-all'` — 关闭全部
+     */
+    builtinMenu?: MeNavBuiltinMenuItem[];
     /**
-     * Tab 切换时触发
-     * @param value - 当前激活的 Tab name
+     * 关闭前的确认函数，返回 false 或 rejected Promise 则阻止关闭
+     * - 同步：返回 boolean
+     * - 异步：返回 Promise<boolean>
+     * @default undefined
      */
-    (e: 'tab-change', value: string): void;
+    beforeClose?: (item: MeNavTabItemData, index: number) => boolean | Promise<boolean>;
     /**
-     * Tab 关闭时触发
-     * @param value - 被关闭的 Tab name
+     * 是否显示边缘渐隐遮罩（暗示还有更多内容）
+     * @default true
      */
-    (e: 'tab-remove', value: string): void;
+    edgeFade?: boolean;
+}
+/** tab-change 事件载荷 */
+export interface MeNavTabChangePayload {
+    /** 激活的 Tab name */
+    name: string;
+    /** 激活的 Tab 数据 */
+    item: MeNavTabItemData;
+    /** 激活的 Tab 索引 */
+    index: number;
+}
+/** tab-remove 事件载荷 */
+export interface MeNavTabRemovePayload {
+    /** 被关闭的 Tab name */
+    name: string;
+    /** 被关闭的 Tab 数据 */
+    item: MeNavTabItemData;
+    /** 被关闭的 Tab 索引 */
+    index: number;
+}
+/** toggle-lock 事件载荷 */
+export interface MeNavToggleLockPayload {
+    /** 操作的 Tab name */
+    name: string;
+    /** 操作的 Tab 数据 */
+    item: MeNavTabItemData;
+    /** 操作的 Tab 索引 */
+    index: number;
+    /** 锁定状态（true 已锁定，false 已解锁） */
+    locked: boolean;
+}
+/** contextmenu 事件载荷 */
+export interface MeNavContextMenuPayload {
+    /** 右键点击的 Tab name */
+    name: string;
+    /** 右键点击的 Tab 数据 */
+    item: MeNavTabItemData;
+    /** 右键点击的 Tab 索引 */
+    index: number;
+    /** 原始鼠标事件 */
+    event: MouseEvent;
+}
+/** 内置菜单操作事件载荷 */
+export interface MeNavBuiltinMenuPayload {
+    /** 操作的 Tab name */
+    name: string;
+    /** 操作的 Tab 数据 */
+    item: MeNavTabItemData;
+    /** 操作的 Tab 索引 */
+    index: number;
+}
+/** MeNav 组件 Emits */
+export interface MeNavEmits {
+    /** Tab 切换时触发（v-model 用） */
+    (e: 'update:modelValue', value: string): void;
+    /** Tab 切换时触发 */
+    (e: 'tab-change', payload: MeNavTabChangePayload): void;
+    /** Tab 关闭时触发 */
+    (e: 'tab-remove', payload: MeNavTabRemovePayload): void;
+    /** Tab 锁定/解锁时触发 */
+    (e: 'toggle-lock', payload: MeNavToggleLockPayload): void;
+    /** 滚动时触发 */
+    (e: 'scroll', translateX: number): void;
+    /** 右键点击 Tab 时触发（菜单显示前） */
+    (e: 'contextmenu', payload: MeNavContextMenuPayload): void;
+    /** 内置菜单 - 刷新当前 */
+    (e: 'refresh', payload: MeNavBuiltinMenuPayload): void;
+    /** 内置菜单 - 关闭当前 */
+    (e: 'close-current', payload: MeNavBuiltinMenuPayload): void;
+    /** 内置菜单 - 关闭其他 */
+    (e: 'close-others', payload: MeNavBuiltinMenuPayload): void;
+    /** 内置菜单 - 关闭左侧 */
+    (e: 'close-left', payload: MeNavBuiltinMenuPayload): void;
+    /** 内置菜单 - 关闭右侧 */
+    (e: 'close-right', payload: MeNavBuiltinMenuPayload): void;
+    /** 内置菜单 - 关闭全部 */
+    (e: 'close-all', payload: MeNavBuiltinMenuPayload): void;
 }
 /** MeNav 组件实例类型 */
 export type MeNavInstance = InstanceType<typeof import('./index.vue').default>;