@das-fed/mframe 0.0.31 → 0.0.33

package/index.d.ts

@@ -74,7 +74,9 @@ declare const channelItem: {
         }>, opt?: {
             notMerge?: boolean;
         } | undefined) => void;
-        get: (keys?: ("visible" | "frameVisible" | "navVisible" | "menuVisible" | "tabVisible" | "mountVisible" | "navRect" | "menuRect" | "tabRect" | "mountRect" | "microApps" | "activeMicroAppName" | "activeMicroAppItem" | "navItems" | "activeNavItem" | "menuItems" | "activeMenuItem" | "fullNavItems" | "tabItems" | "activeTabItem" | "microAppStickStatus" | "initOptions")[] | undefined) => {
+        get: (keys?: ("visible" | "frameVisible" | "navVisible" | "menuVisible" | "tabVisible" | "mountVisible" | "navRect" | "menuRect" | "tabRect" | "mountRect" | "microApps" | "activeMicroAppName" | "activeMicroAppItem" | "navItems" | "activeNavItem" | "menuItems" | "activeMenuItem" | "fullNavItems" | "tabItems" | "activeTabItem" | "microAppStickStatus" | "initOptions")[] | undefined, options?: {
+            clone?: boolean;
+        } | undefined) => {
             /** 整个容器是否显示，默认为true，包括内容区域 */
             visible: boolean | undefined;
             /** 外框是否显示，默认为true，外框包括顶部导航栏，左侧菜单栏，tab标签栏 */
@@ -284,16 +286,23 @@ declare const channelItem_2: {
         set: (payload: Partial<{}>, opt?: {
             notMerge?: boolean;
         } | undefined) => void;
-        get: (keys?: never[] | undefined) => {};
+        get: (keys?: never[] | undefined, options?: {
+            clone?: boolean;
+        } | undefined) => {};
         watch: (cb: (newData: {}, oldData: {}) => any, watchKeys?: never[] | undefined) => () => void;
     };
     cors: {
-        send: (microAppName: string, key: ChildernListener, data?: any) => Promise<any>;
-        on: (name: ParentListener, opt1: any, opt2?: any) => any;
-        once: (name: ParentListener, opt1: any, opt2?: any) => any;
+        send: (microAppName: string, key: ChildernListener, data?: any) => Promise<any[]>;
+        on: (name: ParentListener, opt1: any, opt2?: any) => {
+            cancel: () => void;
+        };
+        once: (name: ParentListener, opt1: any, opt2?: any) => {
+            cancel: () => void;
+        };
     };
     expose: {
         connectMicroApp: (opt: microAppsDataItem) => Promise<void>;
+        disconnectMicroApp: (microAppName: string) => void;
     };
     event: Emitter<Event_3>;
 };
@@ -305,7 +314,9 @@ declare const channelItem_3: {
         }>, opt?: {
             notMerge?: boolean;
         } | undefined) => void;
-        get: (keys?: "appInfo"[] | undefined) => {
+        get: (keys?: "appInfo"[] | undefined, options?: {
+            clone?: boolean;
+        } | undefined) => {
             appInfo: MicroAppItem;
         };
         watch: (cb: (newData: {
@@ -315,16 +326,25 @@ declare const channelItem_3: {
         }) => any, watchKeys?: "appInfo"[] | undefined) => () => void;
     };
     cors: {
-        send: (key: ParentListener_2, data?: any) => Promise<any>;
-        on: (name: ChildernListener_2, opt1?: any, opt2?: any) => any;
-        once: (name: ChildernListener_2, opt1?: any, opt2?: any) => any;
+        send: (key: ParentListener_2, data?: any) => Promise<any[]>;
+        on: (name: ChildernListener_2, opt1?: any, opt2?: any) => {
+            cancel: () => void;
+        };
+        once: (name: ChildernListener_2, opt1?: any, opt2?: any) => {
+            cancel: () => void;
+        };
     };
     event: Emitter<Event_4>;
 };
 
 declare type ChildernListener = 'layoutDataChange' | 'syncRouter' | 'customEventFromMain';
 
-declare type ChildernListener_2 = 'layoutDataChange' | 'syncRouter' | 'customEventFromMain';
+declare type ChildernListener_2 = 'layoutDataChange' | 'syncRouter' | 'customEventFromMain' | 'customEventFromMicro';
+
+/**
+ * 清除实例的所有 bus 数据
+ */
+export declare const clearInstanceBus: (instanceId: string) => void;
 
 declare type ContainerChannelType = {
     container: typeof channelItem;
@@ -349,6 +369,9 @@ declare type ContainerInitOptions = {
 
     /** 预加载配置 */
     preload?: PreloadConfig
+
+    /** 菜单宽度配置，可以是数字（像素）或字符串（如 '200px', '15rem'）*/
+    menuWidth?: number | string
 }
 
 /** 容器初始化方法的结果 */
@@ -368,10 +391,78 @@ declare type ContainerResult = {
 
 export declare const createContainer: (opt?: ContainerInitOptions) => Promise<ContainerResult>;
 
+/**
+ * 实例间通信
+ * 允许不同实例的应用之间通信
+ */
+export declare const createCrossBus: () => {
+    /**
+     * 向指定实例发送消息
+     */
+    send: (targetInstanceId: string, targetChannel: string, eventName: string, data?: any) => void;
+    /**
+     * 监听来自其他实例的消息
+     */
+    on: (currentInstanceId: string, channelName: string, eventName: string, cb: Function) => () => void;
+};
+
+/**
+ * 创建带实例隔离的 bus
+ */
+export declare const createInstanceBus: (instanceId: string) => <Data>(name: string, data?: Data) => {
+    data: {
+        set: (payload: Partial<any>, opt?: {
+            notMerge?: boolean;
+        } | undefined) => void;
+        get: (keys?: (string | number | symbol)[] | undefined) => any;
+        watch: (cb: (newData: any, oldData: any) => void, watchKeys?: (string | number | symbol)[] | undefined) => () => void;
+    };
+    event: {
+        on: (eventName: string, cb: Function) => void;
+        emit: (eventName: string, ...args: any[]) => void;
+        off: (eventName: string, cb?: Function) => void;
+    };
+    cors: {
+        send: (targetName: string, eventName: string, data?: any) => void;
+        on: (eventName: string, cb: Function) => () => void;
+    };
+};
+
 export declare const createMainApp: (opt?: MainAppContainerInitOptions) => Promise<ContainerResult>;
 
 export declare const createMicroApp: (opt?: MicroAppContainerInitOptions) => Promise<MicroAppContainerResult>;
 
+/**
+ * 创建嵌套应用
+ */
+export declare const createNestedApp: (opt?: NestedAppOptions) => Promise<NestedAppResult>;
+
+/**
+ * 创建嵌套实例专用的iframe管理器
+ * 每个嵌套实例都有独立的iframe管理器
+ */
+export declare const createNestedIframeManager: (options: NestedIframeManagerOptions) => {
+    setMountDom: (ele: Element | null) => void;
+    registerIframe: (id: string, config: any) => void;
+    loadIframe: (id: string, opt?: any) => Promise<void>;
+    hideIframe: (iframeId?: string) => void;
+    destroyIframe: (id: string) => void;
+    destroyAll: (clearListeners?: boolean) => void;
+    getIframeInfo: (id: string) => NestedIframeInfo | undefined;
+    checkIframeStatus: (id: string, status: LifeCycleKeyType_2 | LifeCycleKeyType_2[]) => boolean;
+    iframeEvent: Emitter<    {
+    loading: any;
+    error: any;
+    registered: any;
+    mounted: any;
+    unmounted: any;
+    activated: any;
+    deactivated: any;
+    destroy: any;
+    }>;
+    getAllIframes: () => NestedIframeInfo[];
+};
+
 declare type Event_2 = {
     /** 容器组件onMounted生命周期 */
     onMounted: any;
@@ -406,6 +497,99 @@ declare type Event_4 = {
     };
 } & Record<string, any>;
 
+/**
+ * MFrame 实例管理器
+ * 支持多实例场景，每个实例拥有独立的 bus、iframe 管理等
+ */
+export declare interface InstanceConfig {
+    /** 实例 ID（自动生成或手动指定） */
+    id?: string;
+    /** 实例类型 */
+    type: 'main' | 'nested';
+    /** 父实例 ID（用于嵌套场景） */
+    parentId?: string;
+    /** 实例名称（可选，用于调试） */
+    name?: string;
+}
+
+export declare interface InstanceInfo extends Required<InstanceConfig> {
+    /** 创建时间 */
+    createdAt: number;
+    /** 子实例 ID 列表 */
+    children: string[];
+    /** 实例数据 */
+    data: Map<string, any>;
+}
+
+export declare class InstanceManager {
+    private instances;
+    private currentInstanceId;
+    /**
+     * 创建新实例
+     */
+    createInstance(config: InstanceConfig): string;
+    /**
+     * 获取实例信息
+     */
+    getInstance(id: string): InstanceInfo | undefined;
+    /**
+     * 销毁实例
+     */
+    destroyInstance(id: string): void;
+    /**
+     * 设置当前活动实例
+     */
+    setCurrentInstance(id: string): void;
+    /**
+     * 获取当前活动实例 ID
+     */
+    getCurrentInstanceId(): string | null;
+    /**
+     * 获取实例数据
+     */
+    getInstanceData<T = any>(id: string, key: string): T | undefined;
+    /**
+     * 设置实例数据
+     */
+    setInstanceData(id: string, key: string, value: any): void;
+    /**
+     * 获取实例的所有子实例
+     */
+    getChildren(id: string): string[];
+    /**
+     * 获取实例的父实例
+     */
+    getParent(id: string): string | undefined;
+    /**
+     * 获取所有实例
+     */
+    getAllInstances(): InstanceInfo[];
+    /**
+     * 获取实例树结构
+     */
+    getInstanceTree(rootId?: string): any;
+    /**
+     * 打印实例树
+     */
+    printInstanceTree(): void;
+    /**
+     * 生成实例 ID
+     */
+    private generateInstanceId;
+    /**
+     * 检查实例是否存在
+     */
+    hasInstance(id: string): boolean;
+    /**
+     * 获取实例数量
+     */
+    getInstanceCount(): number;
+    /**
+     * 清除所有实例
+     */
+    clearAll(): void;
+}
+
 declare enum LifeCycleKey {
     'registered' = 0,
     'loading' = 1,
@@ -417,8 +601,25 @@ declare enum LifeCycleKey {
     'error' = 7
 }
 
+/**
+ * 嵌套实例专用的 iframe 管理器
+ * 支持独立的生命周期管理和跨实例通信
+ */
+declare enum LifeCycleKey_2 {
+    'registered' = 0,
+    'loading' = 1,
+    'mounted' = 2,
+    'unmounted' = 3,
+    'activated' = 4,
+    'deactivated' = 5,
+    'destroy' = 6,
+    'error' = 7
+}
+
 declare type LifeCycleKeyType = keyof typeof LifeCycleKey;
 
+declare type LifeCycleKeyType_2 = keyof typeof LifeCycleKey_2;
+
 declare type MainAppChannelType = {
     mainApp: typeof channelItem_2;
 };
@@ -487,6 +688,43 @@ declare type NavItem = {
     [key: string]: any
 }
 
+export declare interface NestedAppOptions extends Omit<MainAppContainerInitOptions, 'type'> {
+    /** 父实例 ID（可选，自动检测） */
+    parentInstanceId?: string;
+    /** 嵌套实例名称 */
+    instanceName?: string;
+    /** 是否启用调试日志 */
+    debug?: boolean;
+    /** 是否隔离路由（true: 嵌套实例路由独立，不与浏览器URL同步；false: 路由同步到URL） */
+    isolateRouter?: boolean;
+}
+
+export declare interface NestedAppResult {
+    /** 实例 ID */
+    instanceId: string;
+    /** 实例 bus */
+    bus: ReturnType<typeof createInstanceBus>;
+    /** 内容区挂载点 */
+    mountDom: HTMLDivElement;
+    /** 销毁实例 */
+    destroy: () => void;
+}
+
+declare interface NestedIframeInfo {
+    id: string;
+    config: any;
+    status: LifeCycleKeyType_2;
+    element: HTMLIFrameElement | null;
+    instanceId: string;
+}
+
+declare interface NestedIframeManagerOptions {
+    instanceId: string;
+    debug?: boolean;
+    mountDom?: Element | null;
+    layoutData?: any;
+}
+
 declare type ParentListener = 'getMicroFrameRect' | 'reportRouter' | 'microAppStickStatus' | 'customEventFromMicro';
 
 declare type ParentListener_2 = 'getMicroFrameRect' | 'reportRouter' | 'microAppStickStatus' | 'customEventFromMicro';
@@ -794,6 +1032,11 @@ export declare const useIframePreload: () => {
     };
 };
 
+/**
+ * 获取实例管理器
+ */
+export declare const useInstanceManager: () => InstanceManager;
+
 /**
  * 获取性能监控实例
  */