@ibiz-template/vue3-components 0.7.41-alpha.1 → 0.7.41-alpha.10

package/es/panel-component/app-extend-menu/extend-menu-base/extend-menu-base.util.d.ts

@@ -0,0 +1,175 @@
+import { Ref, VNode } from 'vue';
+import { IAppMenuItem, ILayout } from '@ibiz/model-core';
+import { IAppMenuItemProvider } from '@ibiz-template/runtime';
+import { Namespace } from '@ibiz-template/core';
+/**
+ * @description 组件传参类型定义
+ *
+ * @export
+ * @interface IExtendMenuProps
+ */
+export interface IExtendMenuProps {
+    items: IAppMenuItem[];
+    menuItemsState: {
+        [p: string]: {
+            visible: boolean;
+            permitted: boolean;
+        };
+    };
+    providers: {
+        [key: string]: IAppMenuItemProvider;
+    };
+    position: 'LEFT' | 'RIGHT' | 'TOP' | 'BOTTOM';
+    layoutMode: 'TABLE' | 'TABLE_12COL' | 'TABLE_24COL' | 'FLEX' | 'BORDER' | 'ABSOLUTE';
+    layout: ILayout;
+}
+/**
+ * @description 菜单项绘制数据
+ *
+ * @export
+ * @interface IButtonMenuItem
+ * @extends {IAppMenuItem}
+ */
+export interface IButtonMenuItem extends IAppMenuItem {
+    /** 数据层级 */
+    level: number;
+    /** 主键 */
+    value?: string;
+    /** 主文本 */
+    label?: string;
+    /** 父主键 */
+    parentId?: string;
+    /** 子项数据集合 */
+    children?: IButtonMenuItem[];
+}
+/**
+ * @description 菜单绘制通用参数
+ *
+ * @export
+ * @interface IMenuRenderParams
+ */
+export interface IMenuRenderParams {
+    /** 菜单样式处理命名空间 */
+    ns: Namespace;
+    /** 菜单对齐 */
+    menuAlign: 'horizontal' | 'vertical';
+    /** 菜单项权限数据 */
+    menuItemsState: {
+        [p: string]: {
+            visible: boolean;
+            permitted: boolean;
+        };
+    };
+}
+/**
+ * @description 绘制单个菜单项参数
+ *
+ * @export
+ * @interface IMenuItemParams
+ * @extends {IMenuRenderParams}
+ */
+export interface IMenuItemParams extends IMenuRenderParams {
+    /** 菜单项 */
+    menu: IButtonMenuItem;
+}
+/**
+ * @description 多菜单项（子菜单内容）参数
+ *
+ * @export
+ * @interface IMenuContentParams
+ * @extends {IMenuRenderParams}
+ */
+export interface IMenuContentParams extends IMenuRenderParams {
+    /** 是否支持布局 */
+    isLayout: boolean;
+    /** 菜单方向 */
+    position: string;
+    /** 菜单项绘制数据集合 */
+    menus: IButtonMenuItem[];
+    /** 显示级联箭头 */
+    showCascaderArrow?: boolean;
+    /** 菜单布局模型 */
+    menuLayout?: ILayout;
+    /** 菜单项点击 */
+    handleMenuItemClick: (_menu: IButtonMenuItem, event: MouseEvent) => void;
+    /** 鼠标移入菜单项，准备弹出子菜单 */
+    handleMenuItemMouseEnter: (_menu: IButtonMenuItem, event: MouseEvent) => void;
+    /** 鼠标移出菜单项 */
+    handleMenuItemMouseLeave: (_menu: IButtonMenuItem, event: MouseEvent) => void;
+}
+/**
+ * @description 用于构建级联菜单的弹出层控制逻辑
+ *
+ * - 支持多层级菜单结构；
+ * - 根据鼠标移入/移出控制子菜单弹出与关闭；
+ * - 菜单项移入时打开对应子菜单，移出时自动延迟关闭；
+ * - 子菜单弹出方向根据配置自动计算；
+ * - 支持箭头图标旋转动画；
+ *
+ * @param props - 外部传入的菜单属性，包含菜单项、权限、适配器、布局模式等
+ * @param ns - 命名空间，用于生成 CSS BEM 类名
+ * @param menuAlign - 菜单排列方向（如 vertical）
+ * @param onMenuItemClick - 菜单项点击事件处理器
+ * @param renderCascader - 子菜单内容渲染函数（返回 VNode）
+ *
+ * @returns {
+ *   getOverlayNum: 获取打开的级联数量；
+ *   clearAllCascader: 清除所有层级弹窗和计时器；
+ *   openCascaderPopover: 打开子菜单气泡；
+ *   onMenuItemMouseEnter: 鼠标移入菜单项时的处理函数；
+ *   onMenuItemMouseLeave: 鼠标移出菜单项时的处理函数；
+ * }
+ */
+export declare function useCascaderPopover(props: IExtendMenuProps, ns: Namespace, menuAlign: Ref<string>, renderCascaderContent: (_menu: IButtonMenuItem) => VNode): {
+    getOverlayNum: () => number;
+    clearAllCascader: () => void;
+    openCascaderPopover: (menu: IButtonMenuItem, evt: MouseEvent, opts?: IData) => void;
+    handleMenuItemMouseEnter: (_menu: IButtonMenuItem, _event: MouseEvent) => void;
+    handleMenuItemMouseLeave: (_menu: IButtonMenuItem, _event: MouseEvent) => void;
+};
+/**
+ * @description 用于构建边缘布局弹出层控制逻辑
+ *
+ * - 创建 fixed 占位元素
+ * - 占位块随目标元素变化而更新
+ * - 鼠标悬停触发弹出层
+ * - 移出占位层自动关闭弹层
+ * - 组件卸载自动清理
+ *
+ * @export
+ * @param {(Ref<HTMLElement | undefined>)} menuRef 菜单元素引用
+ * @param {Namespace} ns 命名空间工具
+ * @param {('LEFT' | 'RIGHT' | 'TOP' | 'BOTTOM')} position 元素的方向
+ * @param {Ref<string>} menuAlign 菜单对齐方式
+ * @param {() => number} getOverlayNum 获取当前层级 Overlay 数量
+ * @param {() => VNode} renderBorderContent 渲染边框内容
+ * @returns {
+ *   closeBorderPopover: 关闭边框弹出层
+ * }
+ */
+export declare function useBorderLayout(menuRef: Ref<HTMLElement | undefined>, ns: Namespace, position: 'LEFT' | 'RIGHT' | 'TOP' | 'BOTTOM', menuAlign: Ref<string>, getOverlayNum: () => number, renderBorderContent: () => VNode): {
+    closeBorderPopover: () => void;
+};
+/**
+ * 递归生成菜单数据，递给 element 的 Menu 组件
+ *
+ * @param {AppMenuItemModel[]} items
+ * @return {*}  {IButtonMenuItem[]}
+ */
+export declare function getMenus(items: IAppMenuItem[], _parentItem?: IAppMenuItem, level?: number): IButtonMenuItem[];
+/**
+ * @description 查询菜单项模型
+ *
+ * @export
+ * @param {string} _id 菜单标识
+ * @param {IAppMenuItem[]} items 菜单数据集合
+ * @return {*}  {(IAppMenuItem | undefined)}
+ */
+export declare function findMenuItem(_id: string, items: IAppMenuItem[]): IAppMenuItem | undefined;
+/**
+ * 获取菜单布局样式
+ *
+ * @param {ILayout} [layout] 布局模型
+ * @return {*}
+ */
+export declare function getMenuLayout(layout?: ILayout): IData;

package/es/panel-component/app-extend-menu/extend-menu-base/extend-menu-base.util.mjs

@@ -0,0 +1,349 @@
+import { ref, h, onMounted, onUnmounted } from 'vue';
+
+"use strict";
+function useCascaderPopover(props, ns, menuAlign, renderCascaderContent) {
+  let hoverCount = 0;
+  let closeTimer = null;
+  const overlayInstances = /* @__PURE__ */ new Map();
+  const activeMenuIdStack = ref([]);
+  const rotatedArrowElements = /* @__PURE__ */ new Map();
+  const getOverlayNum = () => {
+    return overlayInstances.size;
+  };
+  const getPopoverPlacement = (level) => {
+    switch (props.position) {
+      case "TOP":
+        return level > 0 ? "right-start" : "bottom-start";
+      case "BOTTOM":
+        return level > 0 ? "right-end" : "top-start";
+      case "RIGHT":
+        return "left-start";
+      case "LEFT":
+        return "right-start";
+      default:
+        return void 0;
+    }
+  };
+  const clearCloseTimer = () => {
+    if (closeTimer) {
+      clearTimeout(closeTimer);
+      closeTimer = null;
+    }
+  };
+  const resetArrowRotation = (ns2, key) => {
+    const arrow = rotatedArrowElements.get(key);
+    if (!arrow)
+      return;
+    arrow.classList.remove(ns2.is("rotate-arrow", true));
+    rotatedArrowElements.delete(key);
+  };
+  const rotateArrowIcon = (el, ns2, key) => {
+    if (el) {
+      el.classList.add(ns2.is("rotate-arrow", true));
+      rotatedArrowElements.set(key, el);
+    }
+  };
+  const closePopoverAtLevel = (key) => {
+    const overlay = overlayInstances.get(key);
+    if (overlay) {
+      overlay.dismiss();
+      overlayInstances.delete(key);
+      resetArrowRotation(ns, key);
+    }
+  };
+  const closeSubsequentPopovers = (currentLevel) => {
+    let level = currentLevel;
+    while (overlayInstances.get(level + 1)) {
+      level++;
+    }
+    for (let i = level; i >= currentLevel; i--) {
+      closePopoverAtLevel(i);
+    }
+  };
+  const closeAllPopovers = () => {
+    for (const key of overlayInstances.keys()) {
+      closePopoverAtLevel(key);
+    }
+    overlayInstances.clear();
+    activeMenuIdStack.value = [];
+    hoverCount = 0;
+  };
+  const scheduleDelayedClose = () => {
+    clearCloseTimer();
+    closeTimer = setTimeout(() => {
+      if (hoverCount <= 0) {
+        closeAllPopovers();
+      }
+    }, 300);
+  };
+  const clearAllCascader = () => {
+    closeAllPopovers();
+    clearCloseTimer();
+  };
+  const handleMenuItemMouseEnter = (_menu, event) => {
+    if (activeMenuIdStack.value.includes(_menu.id))
+      return;
+    activeMenuIdStack.value.push(_menu.id);
+    closeSubsequentPopovers(_menu.level);
+    if (_menu.children) {
+      openCascaderPopover(_menu, event);
+    }
+    clearCloseTimer();
+  };
+  const handleMenuItemMouseLeave = (_menu) => {
+    const index = activeMenuIdStack.value.indexOf(_menu.id);
+    if (index !== -1) {
+      activeMenuIdStack.value.splice(index, 1);
+    }
+    scheduleDelayedClose();
+  };
+  const onPopoverMouseEnter = () => {
+    hoverCount++;
+    clearCloseTimer();
+  };
+  const onPopoverMouseLeave = (_menu, _event) => {
+    hoverCount = Math.max(0, hoverCount - 1);
+    scheduleDelayedClose();
+  };
+  const openCascaderPopover = (menu, evt, opts) => {
+    var _a;
+    const overlay = ibiz.overlay.createPopover(
+      () => h(renderCascaderContent(menu), {
+        onMouseenter: onPopoverMouseEnter,
+        onMouseleave: onPopoverMouseLeave
+      }),
+      void 0,
+      {
+        width: "auto",
+        height: "auto",
+        noArrow: true,
+        placement: getPopoverPlacement(menu.level),
+        offsetOpts: 10,
+        ...opts,
+        modalClass: "".concat(ns.b("cascader-popover"), " ").concat(ns.is(
+          menuAlign.value,
+          true
+        ), " ").concat((opts == null ? void 0 : opts.modalClass) || "")
+      }
+    );
+    overlayInstances.set(menu.level, overlay);
+    overlay == null ? void 0 : overlay.present(evt.currentTarget);
+    rotateArrowIcon(
+      (_a = evt.currentTarget) == null ? void 0 : _a.parentElement,
+      ns,
+      menu.level
+    );
+  };
+  return {
+    getOverlayNum,
+    openCascaderPopover,
+    clearAllCascader,
+    handleMenuItemMouseEnter,
+    handleMenuItemMouseLeave
+  };
+}
+function useBorderLayout(menuRef, ns, position, menuAlign, getOverlayNum, renderBorderContent) {
+  let overlay;
+  const getElementAbsolutePosition = (element) => {
+    let x = 0;
+    let y = 0;
+    let current = element;
+    while (current) {
+      x += current.offsetLeft;
+      y += current.offsetTop;
+      current = current.offsetParent;
+    }
+    return {
+      x,
+      y,
+      width: element.offsetWidth,
+      height: element.offsetHeight
+    };
+  };
+  const resolvePopoverPlacement = () => {
+    switch (position) {
+      case "TOP":
+        return "bottom";
+      case "BOTTOM":
+        return "top";
+      case "RIGHT":
+        return "left";
+      case "LEFT":
+        return "right";
+      default:
+        return void 0;
+    }
+  };
+  let popoverEl;
+  const closeBorderPopover = () => {
+    overlay == null ? void 0 : overlay.dismiss();
+    overlay = null;
+    document.removeEventListener("mousemove", handleMouseTrackOut);
+    popoverEl = void 0;
+  };
+  const handleMouseTrackOut = (e) => {
+    if (!popoverEl) {
+      popoverEl = document.querySelector(
+        ".".concat(ns.b("border-popover"))
+      );
+    }
+    const pos = getElementAbsolutePosition(popoverEl);
+    const isInside = e.pageX >= pos.x && e.pageX <= pos.x + pos.width && e.pageY >= pos.y && e.pageY <= pos.y + pos.height;
+    if (!isInside && getOverlayNum() <= 0) {
+      closeBorderPopover();
+    }
+  };
+  const handlePlaceholderMouseEnter = async (evt) => {
+    var _a;
+    if (overlay)
+      return;
+    overlay = ibiz.overlay.createPopover(
+      () => h(renderBorderContent()),
+      void 0,
+      {
+        width: "auto",
+        height: "auto",
+        noArrow: true,
+        placement: resolvePopoverPlacement(),
+        offsetOpts: -1,
+        modalClass: "".concat(ns.b("border-popover"), " ").concat(ns.is(menuAlign.value, true))
+      }
+    );
+    const triggerEl = (_a = evt.currentTarget) == null ? void 0 : _a.querySelector(
+      ".".concat(ns.be("placehold", "line"))
+    );
+    await (overlay == null ? void 0 : overlay.present(triggerEl));
+    setTimeout(() => {
+      document.addEventListener("mousemove", handleMouseTrackOut);
+    }, 200);
+  };
+  let placeholderEl = null;
+  let resizeObserver = null;
+  let frameLoopId = null;
+  const minWidth = 20;
+  const minHeight = 20;
+  const computeTop = (top, height) => {
+    return position === "BOTTOM" ? top + height - minHeight : top;
+  };
+  const computeLeft = (left, width) => {
+    return position === "RIGHT" ? left + width - minWidth : left;
+  };
+  const computeWidth = (width) => {
+    return ["RIGHT", "LEFT"].includes(position) ? minWidth : width;
+  };
+  const computeHeight = (height) => {
+    return ["TOP", "BOTTOM"].includes(position) ? minHeight : height;
+  };
+  function createFixedPlaceholder(el) {
+    const container = document.createElement("div");
+    container.classList.add(ns.b("placehold"));
+    container.classList.add(ns.is(position.toLowerCase(), !!position));
+    const line = document.createElement("div");
+    line.classList.add(ns.be("placehold", "line"));
+    const arrow = document.createElement("div");
+    arrow.classList.add(ns.be("placehold", "arrow"));
+    container.appendChild(line);
+    container.appendChild(arrow);
+    document.body.appendChild(container);
+    placeholderEl = container;
+    placeholderEl.addEventListener("mouseenter", handlePlaceholderMouseEnter);
+    arrow.innerHTML = '\n      <svg xmlns="http://www.w3.org/2000/svg"\n           viewBox="0 0 1024 1024"\n           width="1em"\n           height="1em"\n           fill="currentColor">\n        <path fill="currentColor"\n              d="M340.864 149.312a30.592 30.592 0 0 0 0 42.752L652.736 512 340.864 831.872a30.592 30.592 0 0 0 0 42.752 29.12 29.12 0 0 0 41.728 0L714.24 534.336a32 32 0 0 0 0-44.672L382.592 149.376a29.12 29.12 0 0 0-41.728 0z">\n        </path>\n      </svg>\n    ';
+    updatePlaceholderPosition(el);
+  }
+  function updatePlaceholderPosition(el) {
+    if (!placeholderEl)
+      return;
+    const rect = el.getBoundingClientRect();
+    placeholderEl.style.top = "".concat(computeTop(rect.top, rect.height), "px");
+    placeholderEl.style.left = "".concat(computeLeft(rect.left, rect.width), "px");
+    placeholderEl.style.width = "".concat(computeWidth(rect.width), "px");
+    placeholderEl.style.height = "".concat(computeHeight(rect.height), "px");
+  }
+  function startTracking() {
+    const el = menuRef.value;
+    if (!el)
+      return;
+    createFixedPlaceholder(el);
+    resizeObserver = new ResizeObserver(() => updatePlaceholderPosition(el));
+    resizeObserver.observe(el);
+    const updateLoop = () => {
+      updatePlaceholderPosition(el);
+      frameLoopId = requestAnimationFrame(updateLoop);
+    };
+    frameLoopId = requestAnimationFrame(updateLoop);
+  }
+  function stopTrackingAndDestroy() {
+    if (resizeObserver) {
+      const el = menuRef.value;
+      if (el)
+        resizeObserver.unobserve(el);
+      resizeObserver.disconnect();
+      resizeObserver = null;
+    }
+    if (frameLoopId !== null) {
+      cancelAnimationFrame(frameLoopId);
+      frameLoopId = null;
+    }
+    if (placeholderEl && placeholderEl.parentNode) {
+      placeholderEl.removeEventListener(
+        "mouseenter",
+        handlePlaceholderMouseEnter
+      );
+      placeholderEl.parentNode.removeChild(placeholderEl);
+      placeholderEl = null;
+    }
+  }
+  onMounted(startTracking);
+  onUnmounted(stopTrackingAndDestroy);
+  return { closeBorderPopover };
+}
+function getMenus(items, _parentItem, level = 0) {
+  return items.map((item) => {
+    var _a;
+    const data = {
+      ...item,
+      value: item.id,
+      label: item.caption,
+      parentId: _parentItem == null ? void 0 : _parentItem.id,
+      level
+    };
+    if ((_a = item.appMenuItems) == null ? void 0 : _a.length) {
+      data.children = getMenus(item.appMenuItems, item, level + 1);
+    }
+    return data;
+  });
+}
+function findMenuItem(_id, items) {
+  let temp;
+  if (items) {
+    items.some((item) => {
+      if (!item.id)
+        return true;
+      if (item.id === _id) {
+        temp = item;
+        return true;
+      }
+      if (item.appMenuItems && item.appMenuItems.length > 0) {
+        temp = findMenuItem(_id, item.appMenuItems);
+        if (!temp) {
+          return false;
+        }
+        return true;
+      }
+      return false;
+    });
+  }
+  return temp;
+}
+function getMenuLayout(layout) {
+  if ((layout == null ? void 0 : layout.layout) === "FLEX") {
+    const { align, valign } = layout;
+    return {
+      justifyContent: align,
+      alignItems: valign
+    };
+  }
+  return {};
+}
+
+export { findMenuItem, getMenuLayout, getMenus, useBorderLayout, useCascaderPopover };

package/es/panel-component/app-extend-menu/index.d.ts

@@ -0,0 +1,5 @@
+import { App } from 'vue';
+declare const _default: {
+    install(app: App): void;
+};
+export default _default;

package/es/panel-component/app-extend-menu/index.mjs

@@ -0,0 +1,18 @@
+import { CommonExtendMenu } from './extend-menu-base/common-extend-menu/common-extend-menu.mjs';
+import IBizLeftSideMenu from './left-side-menu/index.mjs';
+import IBizRightSideMenu from './right-side-menu/index.mjs';
+import IBizBottomSideMenu from './bottom-side-menu/index.mjs';
+import IBizTopSideMenu from './top-side-menu/index.mjs';
+
+"use strict";
+var IBizAppExtendMenu = {
+  install(app) {
+    app.component(CommonExtendMenu.name, CommonExtendMenu);
+    app.use(IBizLeftSideMenu);
+    app.use(IBizRightSideMenu);
+    app.use(IBizBottomSideMenu);
+    app.use(IBizTopSideMenu);
+  }
+};
+
+export { IBizAppExtendMenu as default };

package/es/panel-component/app-extend-menu/left-side-menu/index.d.ts

@@ -0,0 +1,5 @@
+import { App } from 'vue';
+declare const _default: {
+    install(app: App): void;
+};
+export default _default;

package/es/panel-component/app-extend-menu/left-side-menu/index.mjs

@@ -0,0 +1,16 @@
+import { registerPanelItemProvider } from '@ibiz-template/runtime';
+import { LeftSideMenu } from './left-side-menu.mjs';
+import { LeftSideMenuProvider } from './left-side-menu.provider.mjs';
+
+"use strict";
+var IBizLeftSideMenu = {
+  install(app) {
+    app.component(LeftSideMenu.name, LeftSideMenu);
+    registerPanelItemProvider(
+      "RAWITEM_PREDEFINE_LEFT_SIDE_MENU",
+      () => new LeftSideMenuProvider()
+    );
+  }
+};
+
+export { IBizLeftSideMenu as default };

package/es/panel-component/app-extend-menu/left-side-menu/left-side-menu.controller.d.ts

@@ -0,0 +1,10 @@
+import { ExtendMenuBaseController } from '../extend-menu-base/extend-menu-base.controller';
+/**
+ * @description 左侧菜单
+ * @export
+ * @class LeftSideMenuController
+ * @extends {ExtendMenuBaseController}
+ */
+export declare class LeftSideMenuController extends ExtendMenuBaseController {
+    protected appMenuName: string;
+}

package/es/panel-component/app-extend-menu/left-side-menu/left-side-menu.controller.mjs

@@ -0,0 +1,17 @@
+import { ExtendMenuBaseController } from '../extend-menu-base/extend-menu-base.controller.mjs';
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class LeftSideMenuController extends ExtendMenuBaseController {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "appMenuName", "leftsidemenu");
+  }
+}
+
+export { LeftSideMenuController };

package/es/panel-component/app-extend-menu/left-side-menu/left-side-menu.css

@@ -0,0 +1 @@
+.ibiz-left-side-menu{width:100%;height:100%}.ibiz-col--self-align>.ibiz-left-side-menu{width:100%;height:100%}

package/es/panel-component/app-extend-menu/left-side-menu/left-side-menu.d.ts

@@ -0,0 +1,45 @@
+import { PropType } from 'vue';
+import { IPanelRawItem } from '@ibiz/model-core';
+import { LeftSideMenuController } from './left-side-menu.controller';
+import './left-side-menu.scss';
+/**
+ * 左侧菜单
+ * @primary
+ * @description 首页视图扩展菜单左侧菜单
+ * @panelitemparams {name:rendermode,parameterType:'BUTTON' | 'MENU',defaultvalue:BUTTON,description:菜单项绘制模式，其中BUTTON表示按照按钮形态绘制（按钮形态目前仅支持一层）、MENU表示按照菜单形态绘制}
+ * @primary
+ */
+export declare const LeftSideMenu: import("vue").DefineComponent<{
+    /**
+     * @description 模型数据
+     */
+    modelData: {
+        type: PropType<IPanelRawItem>;
+        required: true;
+    };
+    /**
+     * @description 左侧菜单控制器
+     */
+    controller: {
+        type: typeof LeftSideMenuController;
+        required: true;
+    };
+}, {
+    ns: import("@ibiz-template/core").Namespace;
+    state: import("../extend-menu-base/extend-menu-base.state").ExtendMenuBase;
+}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * @description 模型数据
+     */
+    modelData: {
+        type: PropType<IPanelRawItem>;
+        required: true;
+    };
+    /**
+     * @description 左侧菜单控制器
+     */
+    controller: {
+        type: typeof LeftSideMenuController;
+        required: true;
+    };
+}>>, {}, {}>;