import { ReactNode, MouseEventHandler } from 'react'; import { PopperProps } from '@befe/brick-comp-popper'; import { SvgFC } from '@befe/brick-core'; import { MenuSubmenuProps } from './menu-submenu'; export type MenuItemId = string | number | boolean; export type MenuLayout = 'vertical' | 'horizontal' | 'vertical-right'; export declare const MENU_SIZES: readonly ["md", "lg"]; export type MenuSize = (typeof MENU_SIZES)[number]; export type PropsFromPopper = Pick; export type MultipleItemType = 'normal' | 'checkbox'; export declare const SUBMENU_TYPES: readonly ["group", "folder", "popper"]; export type SubmenuType = (typeof SUBMENU_TYPES)[number]; export declare const SUBMENU_TYPE_DEFAULT = "folder"; export declare const SUBMENU_SELECTABLE_DEFAULT = false; export declare const SUBMENU_POPPER_TRIGGER_TYPE_DEFAULT = "hover"; /** * 由父级 level 推出当前 Menu 的 level。level 语义: * - `0`:不参与层级缩进(非 vertical+nav 根、或 popper 子树),**粘滞**——其下所有层级都保持 0; * - `>=1`:参与缩进的 vertical+nav 内联树里的深度(根 Menu 为 1,逐层 +1)。 * * 规则:根 Menu(`parentLevel` 缺省)参与则取 1、否则 0;父级为 0 则粘滞 0;其余逐层 +1。 */ export declare function resolveMenuLevel(parentLevel: number | undefined, activeAtRoot: boolean): number; export interface MenuLevelIndentParams { /** * 当前菜单项所在层级(见 `resolveMenuLevel`);`< 2`(即 0 不参与 / 1 为第一层)不缩进 */ level?: number; /** * 尺寸 */ size?: MenuSize; /** * 根菜单是否含 prefix icon(只在根 Menu 计算,经 context 透传到各层) */ withPrefixIcon?: boolean; } /** * 计算 nav 垂直菜单某一层级 item 的 padding-left(替代原顶层 nav 的「穷举层级纯 CSS」实现)。 * * `level < 2` 时返回 `undefined`、不写 inline:`0` = 非 vertical+nav 根 / popper 子树(不参与缩进), * `1` = 第一层(沿用 CSS 默认 padding)。 * * 数值走 core 派生层(对齐 _menu.scss / _base.scss):base = `padding(5)`(↔ `$menu-nav-item-padding-horizontal`), * 含 prefix icon 再加 `fontSize(size) + padding(2)`(↔ `$menu-item-prefix-margin`); * 公式 `padding-left = base + fontSize(size) * (level - 1)`。支持任意层级,无 `$menu-max-level` 上限。 */ export declare function getMenuLevelIndent(params: MenuLevelIndentParams): number | undefined; export interface MenuItemObject { /** * 唯一标识 */ id?: MenuItemId; /** * 显示内容 */ label: ReactNode; /** * 是否禁用 */ disabled?: boolean; /** * icon,只支持第一层有 icon */ icon?: SvgFC; /** * 链接地址,item label 将 wrap 在 元素内 */ href?: string; /** * 的 target */ target?: string; /** * title tip */ title?: string; /** * 点击回调 */ onClick?: MouseEventHandler; /** * (submenu)类型 */ type?: MenuSubmenuProps['type']; /** * 是否选中 */ selected?: MenuSubmenuProps['selected']; /** * (submenu)是否展开 */ expanded?: MenuSubmenuProps['expanded']; /** * 子项 */ children?: MenuItemObject[]; } export interface NavProps { /** * menu */ menu?: T[]; /** * menu 已选择的 id 列表 控制值 * * 注意,如果选择用此 prop 控制 menu 的已选择,须保持 `menuItem.selected` 为 `undefined` */ menuSelectedIds?: MenuItemId[]; /** * menu 已选择的 id 列表 默认值 */ menuDefaultSelectedIds?: MenuItemId[]; /** * menu 已展开的 submenu id 列表 控制值 * * 注意,如果选择用此 prop 控制 menu 中 submenu 展开/收起,须保持 `menuItem.expanded` 为 `undefined` */ menuExpandedIds?: MenuItemId[]; /** * menu 已展开的 submenu id 列表 默认值 */ menuDefaultExpandedIds?: MenuItemId[]; } export declare function isValidMenuId(id: unknown): id is MenuItemId; type Checker = K | ((item: T) => boolean); /** * 有控制值返回 MenuItemId[] * 否则返回 null */ export declare function collectMenuIdsByCheckingControlProp(menu: T[] | undefined, checker: Checker): null | MenuItemId[]; export declare function getControlledMenuIdsFromProps(props: NavProps, propName: keyof NavProps, checker: Checker): MenuItemId[] | null; export {};