@das-fed/mframe 0.0.27 → 0.0.29

package/index.d.ts

@@ -346,6 +346,9 @@ declare type ContainerInitOptions = {
 
     /** 作为子应用时，是否自动清除html、body、挂载点的背景颜色。默认清除，防止子应用的背景颜色覆盖主应用，但是会自动继到可用的布局容器中 */
     autoClearBackground?: Boolean
+
+    /** 预加载配置 */
+    preload?: PreloadConfig
 }
 
 /** 容器初始化方法的结果 */
@@ -423,6 +426,19 @@ declare type MainAppChannelType = {
 /** 主应用的初始化配置 */
 declare type MainAppContainerInitOptions = Omit<ContainerInitOptions, 'type' | 'autoClearBackground'>
 
+export declare interface MemoryMetric {
+    /** 应用名称 */
+    appName: string;
+    /** 内存使用（字节） */
+    usedJSHeapSize?: number;
+    /** 总内存（字节） */
+    totalJSHeapSize?: number;
+    /** 内存限制（字节） */
+    jsHeapSizeLimit?: number;
+    /** 记录时间 */
+    timestamp: number;
+}
+
 declare type MenuItem = {
     label: string
     value: string
@@ -475,11 +491,122 @@ declare type ParentListener = 'getMicroFrameRect' | 'reportRouter' | 'microAppSt
 
 declare type ParentListener_2 = 'getMicroFrameRect' | 'reportRouter' | 'microAppStickStatus' | 'customEventFromMicro';
 
+/**
+ * 性能监控工具
+ */
+export declare interface PerformanceMetric {
+    /** 应用名称 */
+    appName: string;
+    /** 加载开始时间 */
+    startTime: number;
+    /** 加载结束时间 */
+    endTime?: number;
+    /** 加载耗时（毫秒） */
+    loadTime?: number;
+    /** 状态：loading, loaded, error */
+    status: 'loading' | 'loaded' | 'error';
+    /** 错误信息 */
+    error?: string;
+}
+
+declare class PerformanceMonitor {
+    private loadMetrics;
+    private memoryMetrics;
+    private routerMetrics;
+    private routerStartTime;
+    private routerFrom;
+    /**
+     * 记录应用开始加载
+     */
+    startLoad(appName: string): void;
+    /**
+     * 记录应用加载完成
+     */
+    endLoad(appName: string, success?: boolean, error?: string): void;
+    /**
+     * 记录内存使用
+     */
+    recordMemory(appName: string): void;
+    /**
+     * 记录路由开始切换
+     */
+    startRouterChange(from: string): void;
+    /**
+     * 记录路由切换完成
+     */
+    endRouterChange(to: string): void;
+    /**
+     * 获取性能报告
+     */
+    getReport(): PerformanceReport;
+    /**
+     * 打印性能报告
+     */
+    printReport(): PerformanceReport;
+    /**
+     * 清除所有指标
+     */
+    clear(): void;
+    /**
+     * 启用自动内存监控
+     */
+    enableAutoMemoryMonitor(interval?: number): () => void;
+}
+
+export declare interface PerformanceReport {
+    /** 加载指标 */
+    loadMetrics: PerformanceMetric[];
+    /** 内存指标 */
+    memoryMetrics: MemoryMetric[];
+    /** 路由指标 */
+    routerMetrics: RouterMetric[];
+    /** 平均加载时间（毫秒） */
+    averageLoadTime: number;
+    /** 最慢的应用 */
+    slowestApp?: string;
+    /** 最快的应用 */
+    fastestApp?: string;
+    /** 当前总内存使用（MB） */
+    totalMemoryUsage?: number;
+}
+
 export declare const pollVariable: <T>(getDataFn: () => any, opt?: {
     interval: number;
     times: number;
 }) => Promise<T>;
 
+/** 预加载配置 */
+declare type PreloadConfig = {
+    /** 是否启用预加载，默认 false */
+    enabled?: boolean
+
+    /** 预加载策略：idle-浏览器空闲时，immediate-立即，visible-页面可见时 */
+    strategy?: 'idle' | 'immediate' | 'visible'
+
+    /** 延迟预加载的时间（毫秒），仅当 strategy 为 immediate 时有效 */
+    delay?: number
+
+    /** 指定要预加载的应用名称列表，为空则预加载所有子应用 */
+    apps?: string[]
+}
+
+declare interface PreloadedIframe {
+    id: string;
+    iframe: HTMLIFrameElement;
+    origin: string;
+    status: 'loading' | 'ready' | 'error';
+    loadTime?: number;
+}
+
+declare interface PreloadOptions {
+    /** 预加载的应用列表 */
+    apps?: MicroAppItem[];
+    /** 预加载策略 */
+    strategy?: 'idle' | 'immediate' | 'visible';
+    /** 自定义预加载时机（毫秒） */
+    delay?: number;
+}
+
 export declare const reportRouter: (data?: any) => Promise<void>;
 
 declare type RouterConfig = {
@@ -495,12 +622,125 @@ declare type RouterConfig = {
 
 declare type RouterEventListenerTypes = 'replaceState' | 'pushState';
 
+export declare interface RouterMetric {
+    /** 从哪个路由 */
+    from: string;
+    /** 到哪个路由 */
+    to: string;
+    /** 耗时（毫秒） */
+    duration: number;
+    /** 时间戳 */
+    timestamp: number;
+}
+
+export declare class RouterSyncManager {
+    private syncLock;
+    private lastSync;
+    private debounceTimer;
+    private options;
+    private syncHistory;
+    private maxHistorySize;
+    constructor(options?: RouterSyncOptions);
+    /**
+     * 检查是否应该同步（防止死循环）
+     */
+    shouldSync(path: string, source: SyncSource): boolean;
+    /**
+     * 开始同步（加锁）
+     */
+    startSync(path: string, source: SyncSource): boolean;
+    /**
+     * 结束同步（解锁）
+     */
+    endSync(source: SyncSource, delay?: number): void;
+    /**
+     * 防抖执行
+     */
+    debounce(fn: () => void): void;
+    /**
+     * 取消防抖
+     */
+    cancelDebounce(): void;
+    /**
+     * 检查是否有锁
+     */
+    hasLock(source?: SyncSource): boolean;
+    /**
+     * 加锁
+     */
+    private lock;
+    /**
+     * 解锁
+     */
+    private unlock;
+    /**
+     * 强制解锁所有
+     */
+    unlockAll(): void;
+    /**
+     * 获取同步历史
+     */
+    getHistory(): SyncRecord[];
+    /**
+     * 清除历史
+     */
+    clearHistory(): void;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        total: number;
+        bySource: {
+            main: number;
+            micro: number;
+            popstate: number;
+        };
+        lastSync: SyncRecord | null;
+        hasLock: boolean;
+    };
+    /**
+     * 打印统计信息
+     */
+    printStats(): void;
+    /**
+     * 调试日志
+     */
+    private log;
+    /**
+     * 重置管理器
+     */
+    reset(): void;
+}
+
+/**
+ * 路由同步管理器
+ * 解决路由同步死循环和防抖问题
+ */
+export declare interface RouterSyncOptions {
+    /** 防抖延迟（毫秒），默认 50ms */
+    debounceDelay?: number;
+    /** 是否启用调试日志 */
+    debug?: boolean;
+}
+
+export declare interface SyncRecord {
+    path: string;
+    source: SyncSource;
+    timestamp: number;
+}
+
 export declare const syncRouter: (cb: (params: {
     appInfo: any;
     parentRouter: any;
     replacePath: string;
 }) => any) => void;
 
+export declare enum SyncSource {
+    MAIN = "main",// 主应用触发
+    MICRO = "micro",// 子应用触发
+    POPSTATE = "popstate"
+}
+
 declare type TabItem = {
     label: string
     value: string
@@ -527,6 +767,38 @@ export declare const useIframeManager: () => {
     destroyIframe: (id: string) => void;
 };
 
+/**
+ * iframe 预加载管理器
+ */
+export declare const useIframePreload: () => {
+    preload: (id: string, origin: string) => Promise<PreloadedIframe>;
+    preloadBatch: (apps: MicroAppItem[]) => Promise<PreloadedIframe[]>;
+    getPreloaded: (id: string) => PreloadedIframe | null;
+    moveToContainer: (id: string, targetContainer: Element) => HTMLIFrameElement | null;
+    clearPreload: (id: string) => void;
+    clearAll: () => void;
+    preloadOnIdle: (apps: MicroAppItem[]) => void;
+    preloadImmediate: (apps: MicroAppItem[]) => Promise<PreloadedIframe[]>;
+    preloadWithStrategy: (options: PreloadOptions) => void;
+    getStats: () => {
+        total: number;
+        ready: number;
+        loading: number;
+        error: number;
+        averageLoadTime: number;
+        details: Array<{
+            id: string;
+            status: string;
+            loadTime?: number;
+        }>;
+    };
+};
+
+/**
+ * 获取性能监控实例
+ */
+export declare const usePerformanceMonitor: () => PerformanceMonitor;
+
 export declare const useRouter: () => {
     replaceState: (path: string) => void;
     addRule: (key: string, rule: string | string[]) => void;
@@ -538,4 +810,9 @@ export declare const useRouterEventListener: () => {
     removeRouterEventListener: (type?: RouterEventListenerTypes | RouterEventListenerTypes[]) => void;
 };
 
+/**
+ * 获取路由同步管理器实例
+ */
+export declare const useRouterSyncManager: (options?: RouterSyncOptions) => RouterSyncManager;
+
 export { }