electron-infra-kit 0.0.2

package/dist/core/window/WindowCreator.js

@@ -0,0 +1,168 @@
+'use strict';var ElectronLogger=require('../../infrastructure/logger/ElectronLogger.js');/**
+ * WindowCreator - Universal window creation helper class
+ * WindowCreator - 通用窗口创建辅助类
+ *
+ * Handles window creation, restoration, display, and exception recovery.
+ * 用于处理窗口创建、恢复、显示以及异常恢复逻辑。
+ */
+class WindowCreator {
+    api;
+    data;
+    winId;
+    creator;
+    extraOptions;
+    logger;
+    /**
+     * Constructor
+     * 构造函数
+     *
+     * @param api - WindowManager API interface (WindowManager API 接口)
+     * @param data - Data object passed to the window, including winId (传递给窗口的数据对象，包含 winId)
+     * @param creator - Window creation function (窗口创建函数)
+     * @param extraOptions - Optional function to generate extra configuration (可选的额外配置生成函数)
+     * @param logger - Optional logger instance (可选的日志实例)
+     */
+    constructor(api, data, creator, extraOptions, logger) {
+        this.api = api;
+        this.data = data;
+        this.winId = data?.data?.winId || '';
+        this.creator = creator;
+        this.extraOptions = extraOptions;
+        this.logger = logger || new ElectronLogger.ElectronLogger({ appName: 'WindowCreator' });
+    }
+    /**
+     * Internal method: Create window
+     * 内部方法：创建窗口
+     *
+     * Checks if window exists. If it exists but is destroyed, cleans up and recreates.
+     * 检查窗口是否存在。如果存在但已销毁，则清理并重新创建。
+     *
+     * @returns Object containing window ID and isNew flag (包含窗口 ID 和是否为新创建标志的对象)
+     */
+    async createWindow() {
+        let isNew = false;
+        // Check if window exists
+        // 检查窗口是否存在
+        if (this.winId && this.api.window.hasById(this.winId)) {
+            // If exists but destroyed, clean it up
+            // 如果存在但已销毁，进行清理
+            if (this.api.window.isDestroyed(this.winId)) {
+                this.logger.warn(`Window ${this.winId} is found in store but destroyed. Cleaning up and recreating.`);
+                // Clean up using the API which should handle both ID and Name maps if possible
+                // 使用 API 清理，应该同时处理 ID 和名称映射
+                await this.api.window.removeWindow(this.winId);
+            }
+            else {
+                // Window exists and is valid
+                // 窗口存在且有效
+                return { winId: this.winId, isNew: false };
+            }
+        }
+        // Create new window instance
+        // 创建新窗口实例
+        const options = this.winId
+            ? {
+                windowId: this.winId,
+                ...(this.extraOptions?.(this.data.data) || {}),
+            }
+            : this.data.data;
+        this.winId = await this.creator(options);
+        isNew = true;
+        return { winId: this.winId, isNew };
+    }
+    /**
+     * Internal method: Show window
+     * 内部方法：显示窗口
+     *
+     * @param winId - Window ID (窗口 ID)
+     * @param isNew - Is newly created (是否为新创建)
+     */
+    showWindow(winId, isNew) {
+        const win = this.api.window.getTargetWindow(winId);
+        if (!win || win.isDestroyed()) {
+            this.logger.error(`Failed to show window ${winId}: Window not found or destroyed`);
+            return;
+        }
+        if (isNew) {
+            // For new windows, wait for ready-to-show to prevent flickering
+            // 对于新窗口，等待 ready-to-show 事件以防止闪烁
+            win.once('ready-to-show', () => {
+                this.api.window.show(win, winId);
+            });
+        }
+        else {
+            // For existing windows, show immediately
+            // 对于现有窗口，立即显示
+            this.api.window.show(win, winId);
+        }
+    }
+    /**
+     * Internal method: Load content
+     * 内部方法：加载内容
+     */
+    async loadContent(winId, options) {
+        const win = this.api.window.getTargetWindow(winId);
+        if (!win || win.isDestroyed())
+            return;
+        // Handle custom load handler
+        // 处理自定义加载处理程序
+        if (options.loadWindowContent) {
+            try {
+                await options.loadWindowContent(win);
+            }
+            catch (e) {
+                this.logger.error(`Custom loadWindowContent failed for window ${winId}: ${e}`);
+            }
+            return;
+        }
+        if (this.data.contentLoader) {
+            try {
+                await this.data.contentLoader(win, options);
+            }
+            catch (e) {
+                this.logger.error(`Global contentLoader failed for window ${winId}: ${e}`);
+            }
+            return;
+        }
+        if (options.loadUrl) {
+            win.loadURL(options.loadUrl).catch((e) => {
+                this.logger.error(`Failed to load URL "${options.loadUrl}" for window ${winId}: ${e}`);
+            });
+        }
+        else if (options.loadFile) {
+            win.loadFile(options.loadFile).catch((e) => {
+                this.logger.error(`Failed to load file "${options.loadFile}" for window ${winId}: ${e}`);
+            });
+        }
+    }
+    /**
+     * Create and show window
+     * 创建并显示窗口
+     *
+     * If window exists, restores and focuses it. If not, creates it.
+     * 如果窗口已存在则恢复并聚焦，如果不存在则创建。
+     *
+     * @returns Window ID (窗口 ID)
+     */
+    async createAndShow() {
+        try {
+            const { isNew } = await this.createWindow();
+            // Load content if it's a new window
+            if (isNew) {
+                const options = this.winId
+                    ? {
+                        windowId: this.winId,
+                        ...(this.extraOptions?.(this.data.data) || {}),
+                    }
+                    : this.data.data;
+                await this.loadContent(this.winId, options);
+            }
+            this.showWindow(this.winId, isNew);
+            return this.winId;
+        }
+        catch (error) {
+            this.logger.error(`Failed to create and show window: ${error}`);
+            throw error;
+        }
+    }
+}module.exports=WindowCreator;//# sourceMappingURL=WindowCreator.js.map

package/dist/core/window/WindowCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowCreator.js","sources":["../../../src/core/window/WindowCreator.ts"],"sourcesContent":["import { Logger, ILogger } from '@/infrastructure/logger';\nimport type { WindowManagerApi, WindowCreationOptions } from './window-manager.type';\n\n/**\n * WindowCreator - Universal window creation helper class\n * WindowCreator - 通用窗口创建辅助类\n *\n * Handles window creation, restoration, display, and exception recovery.\n * 用于处理窗口创建、恢复、显示以及异常恢复逻辑。\n */\nexport default class WindowCreator<T = WindowCreationOptions> {\n  private api: WindowManagerApi;\n  private data: {\n    data: T & { winId?: string };\n    contentLoader?: (window: any, options: any) => Promise<void> | void;\n  };\n  private winId: string;\n  private creator: (options: WindowCreationOptions) => string | Promise<string>;\n  private extraOptions?: (data: T) => object;\n  private logger: ILogger;\n\n  /**\n   * Constructor\n   * 构造函数\n   *\n   * @param api - WindowManager API interface (WindowManager API 接口)\n   * @param data - Data object passed to the window, including winId (传递给窗口的数据对象，包含 winId)\n   * @param creator - Window creation function (窗口创建函数)\n   * @param extraOptions - Optional function to generate extra configuration (可选的额外配置生成函数)\n   * @param logger - Optional logger instance (可选的日志实例)\n   */\n  constructor(\n    api: WindowManagerApi,\n    data: {\n      data: T & { winId?: string };\n      contentLoader?: (window: any, options: any) => Promise<void> | void;\n    },\n    creator: (options: WindowCreationOptions) => string | Promise<string>,\n    extraOptions?: (data: T) => object,\n    logger?: ILogger\n  ) {\n    this.api = api;\n    this.data = data;\n    this.winId = data?.data?.winId || '';\n    this.creator = creator;\n    this.extraOptions = extraOptions;\n    this.logger = logger || new Logger({ appName: 'WindowCreator' });\n  }\n\n  /**\n   * Internal method: Create window\n   * 内部方法：创建窗口\n   *\n   * Checks if window exists. If it exists but is destroyed, cleans up and recreates.\n   * 检查窗口是否存在。如果存在但已销毁，则清理并重新创建。\n   *\n   * @returns Object containing window ID and isNew flag (包含窗口 ID 和是否为新创建标志的对象)\n   */\n  private async createWindow(): Promise<{ winId: string; isNew: boolean }> {\n    let isNew = false;\n\n    // Check if window exists\n    // 检查窗口是否存在\n    if (this.winId && this.api.window.hasById(this.winId)) {\n      // If exists but destroyed, clean it up\n      // 如果存在但已销毁，进行清理\n      if (this.api.window.isDestroyed(this.winId)) {\n        this.logger.warn(\n          `Window ${this.winId} is found in store but destroyed. Cleaning up and recreating.`\n        );\n        // Clean up using the API which should handle both ID and Name maps if possible\n        // 使用 API 清理，应该同时处理 ID 和名称映射\n        await this.api.window.removeWindow(this.winId);\n      } else {\n        // Window exists and is valid\n        // 窗口存在且有效\n        return { winId: this.winId, isNew: false };\n      }\n    }\n\n    // Create new window instance\n    // 创建新窗口实例\n    const options = this.winId\n      ? {\n          windowId: this.winId,\n          ...(this.extraOptions?.(this.data.data) || {}),\n        }\n      : this.data.data;\n\n    this.winId = await this.creator(options);\n    isNew = true;\n\n    return { winId: this.winId, isNew };\n  }\n\n  /**\n   * Internal method: Show window\n   * 内部方法：显示窗口\n   *\n   * @param winId - Window ID (窗口 ID)\n   * @param isNew - Is newly created (是否为新创建)\n   */\n  private showWindow(winId: string, isNew: boolean): void {\n    const win = this.api.window.getTargetWindow(winId);\n\n    if (!win || win.isDestroyed()) {\n      this.logger.error(`Failed to show window ${winId}: Window not found or destroyed`);\n      return;\n    }\n\n    if (isNew) {\n      // For new windows, wait for ready-to-show to prevent flickering\n      // 对于新窗口，等待 ready-to-show 事件以防止闪烁\n      win.once('ready-to-show', () => {\n        this.api.window.show(win, winId);\n      });\n    } else {\n      // For existing windows, show immediately\n      // 对于现有窗口，立即显示\n      this.api.window.show(win, winId);\n    }\n  }\n\n  /**\n   * Internal method: Load content\n   * 内部方法：加载内容\n   */\n  private async loadContent(winId: string, options: WindowCreationOptions): Promise<void> {\n    const win = this.api.window.getTargetWindow(winId);\n    if (!win || win.isDestroyed()) return;\n\n    // Handle custom load handler\n    // 处理自定义加载处理程序\n    if (options.loadWindowContent) {\n      try {\n        await options.loadWindowContent(win);\n      } catch (e) {\n        this.logger.error(`Custom loadWindowContent failed for window ${winId}: ${e}`);\n      }\n      return;\n    }\n\n    if (this.data.contentLoader) {\n      try {\n        await this.data.contentLoader(win, options);\n      } catch (e) {\n        this.logger.error(`Global contentLoader failed for window ${winId}: ${e}`);\n      }\n      return;\n    }\n\n    if (options.loadUrl) {\n      win.loadURL(options.loadUrl).catch((e) => {\n        this.logger.error(`Failed to load URL \"${options.loadUrl}\" for window ${winId}: ${e}`);\n      });\n    } else if (options.loadFile) {\n      win.loadFile(options.loadFile).catch((e) => {\n        this.logger.error(`Failed to load file \"${options.loadFile}\" for window ${winId}: ${e}`);\n      });\n    }\n  }\n\n  /**\n   * Create and show window\n   * 创建并显示窗口\n   *\n   * If window exists, restores and focuses it. If not, creates it.\n   * 如果窗口已存在则恢复并聚焦，如果不存在则创建。\n   *\n   * @returns Window ID (窗口 ID)\n   */\n  public async createAndShow(): Promise<string> {\n    try {\n      const { isNew } = await this.createWindow();\n\n      // Load content if it's a new window\n      if (isNew) {\n        const options = this.winId\n          ? {\n              windowId: this.winId,\n              ...(this.extraOptions?.(this.data.data) || {}),\n            }\n          : this.data.data;\n        await this.loadContent(this.winId, options);\n      }\n\n      this.showWindow(this.winId, isNew);\n      return this.winId;\n    } catch (error) {\n      this.logger.error(`Failed to create and show window: ${error}`);\n      throw error;\n    }\n  }\n}\n"],"names":["Logger"],"mappings":"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"}

package/dist/core/window/WindowCreator.mjs

@@ -0,0 +1,168 @@
+import {ElectronLogger}from'../../infrastructure/logger/ElectronLogger.mjs';/**
+ * WindowCreator - Universal window creation helper class
+ * WindowCreator - 通用窗口创建辅助类
+ *
+ * Handles window creation, restoration, display, and exception recovery.
+ * 用于处理窗口创建、恢复、显示以及异常恢复逻辑。
+ */
+class WindowCreator {
+    api;
+    data;
+    winId;
+    creator;
+    extraOptions;
+    logger;
+    /**
+     * Constructor
+     * 构造函数
+     *
+     * @param api - WindowManager API interface (WindowManager API 接口)
+     * @param data - Data object passed to the window, including winId (传递给窗口的数据对象，包含 winId)
+     * @param creator - Window creation function (窗口创建函数)
+     * @param extraOptions - Optional function to generate extra configuration (可选的额外配置生成函数)
+     * @param logger - Optional logger instance (可选的日志实例)
+     */
+    constructor(api, data, creator, extraOptions, logger) {
+        this.api = api;
+        this.data = data;
+        this.winId = data?.data?.winId || '';
+        this.creator = creator;
+        this.extraOptions = extraOptions;
+        this.logger = logger || new ElectronLogger({ appName: 'WindowCreator' });
+    }
+    /**
+     * Internal method: Create window
+     * 内部方法：创建窗口
+     *
+     * Checks if window exists. If it exists but is destroyed, cleans up and recreates.
+     * 检查窗口是否存在。如果存在但已销毁，则清理并重新创建。
+     *
+     * @returns Object containing window ID and isNew flag (包含窗口 ID 和是否为新创建标志的对象)
+     */
+    async createWindow() {
+        let isNew = false;
+        // Check if window exists
+        // 检查窗口是否存在
+        if (this.winId && this.api.window.hasById(this.winId)) {
+            // If exists but destroyed, clean it up
+            // 如果存在但已销毁，进行清理
+            if (this.api.window.isDestroyed(this.winId)) {
+                this.logger.warn(`Window ${this.winId} is found in store but destroyed. Cleaning up and recreating.`);
+                // Clean up using the API which should handle both ID and Name maps if possible
+                // 使用 API 清理，应该同时处理 ID 和名称映射
+                await this.api.window.removeWindow(this.winId);
+            }
+            else {
+                // Window exists and is valid
+                // 窗口存在且有效
+                return { winId: this.winId, isNew: false };
+            }
+        }
+        // Create new window instance
+        // 创建新窗口实例
+        const options = this.winId
+            ? {
+                windowId: this.winId,
+                ...(this.extraOptions?.(this.data.data) || {}),
+            }
+            : this.data.data;
+        this.winId = await this.creator(options);
+        isNew = true;
+        return { winId: this.winId, isNew };
+    }
+    /**
+     * Internal method: Show window
+     * 内部方法：显示窗口
+     *
+     * @param winId - Window ID (窗口 ID)
+     * @param isNew - Is newly created (是否为新创建)
+     */
+    showWindow(winId, isNew) {
+        const win = this.api.window.getTargetWindow(winId);
+        if (!win || win.isDestroyed()) {
+            this.logger.error(`Failed to show window ${winId}: Window not found or destroyed`);
+            return;
+        }
+        if (isNew) {
+            // For new windows, wait for ready-to-show to prevent flickering
+            // 对于新窗口，等待 ready-to-show 事件以防止闪烁
+            win.once('ready-to-show', () => {
+                this.api.window.show(win, winId);
+            });
+        }
+        else {
+            // For existing windows, show immediately
+            // 对于现有窗口，立即显示
+            this.api.window.show(win, winId);
+        }
+    }
+    /**
+     * Internal method: Load content
+     * 内部方法：加载内容
+     */
+    async loadContent(winId, options) {
+        const win = this.api.window.getTargetWindow(winId);
+        if (!win || win.isDestroyed())
+            return;
+        // Handle custom load handler
+        // 处理自定义加载处理程序
+        if (options.loadWindowContent) {
+            try {
+                await options.loadWindowContent(win);
+            }
+            catch (e) {
+                this.logger.error(`Custom loadWindowContent failed for window ${winId}: ${e}`);
+            }
+            return;
+        }
+        if (this.data.contentLoader) {
+            try {
+                await this.data.contentLoader(win, options);
+            }
+            catch (e) {
+                this.logger.error(`Global contentLoader failed for window ${winId}: ${e}`);
+            }
+            return;
+        }
+        if (options.loadUrl) {
+            win.loadURL(options.loadUrl).catch((e) => {
+                this.logger.error(`Failed to load URL "${options.loadUrl}" for window ${winId}: ${e}`);
+            });
+        }
+        else if (options.loadFile) {
+            win.loadFile(options.loadFile).catch((e) => {
+                this.logger.error(`Failed to load file "${options.loadFile}" for window ${winId}: ${e}`);
+            });
+        }
+    }
+    /**
+     * Create and show window
+     * 创建并显示窗口
+     *
+     * If window exists, restores and focuses it. If not, creates it.
+     * 如果窗口已存在则恢复并聚焦，如果不存在则创建。
+     *
+     * @returns Window ID (窗口 ID)
+     */
+    async createAndShow() {
+        try {
+            const { isNew } = await this.createWindow();
+            // Load content if it's a new window
+            if (isNew) {
+                const options = this.winId
+                    ? {
+                        windowId: this.winId,
+                        ...(this.extraOptions?.(this.data.data) || {}),
+                    }
+                    : this.data.data;
+                await this.loadContent(this.winId, options);
+            }
+            this.showWindow(this.winId, isNew);
+            return this.winId;
+        }
+        catch (error) {
+            this.logger.error(`Failed to create and show window: ${error}`);
+            throw error;
+        }
+    }
+}export{WindowCreator as default};//# sourceMappingURL=WindowCreator.mjs.map

package/dist/core/window/WindowCreator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowCreator.mjs","sources":["../../../src/core/window/WindowCreator.ts"],"sourcesContent":["import { Logger, ILogger } from '@/infrastructure/logger';\nimport type { WindowManagerApi, WindowCreationOptions } from './window-manager.type';\n\n/**\n * WindowCreator - Universal window creation helper class\n * WindowCreator - 通用窗口创建辅助类\n *\n * Handles window creation, restoration, display, and exception recovery.\n * 用于处理窗口创建、恢复、显示以及异常恢复逻辑。\n */\nexport default class WindowCreator<T = WindowCreationOptions> {\n  private api: WindowManagerApi;\n  private data: {\n    data: T & { winId?: string };\n    contentLoader?: (window: any, options: any) => Promise<void> | void;\n  };\n  private winId: string;\n  private creator: (options: WindowCreationOptions) => string | Promise<string>;\n  private extraOptions?: (data: T) => object;\n  private logger: ILogger;\n\n  /**\n   * Constructor\n   * 构造函数\n   *\n   * @param api - WindowManager API interface (WindowManager API 接口)\n   * @param data - Data object passed to the window, including winId (传递给窗口的数据对象，包含 winId)\n   * @param creator - Window creation function (窗口创建函数)\n   * @param extraOptions - Optional function to generate extra configuration (可选的额外配置生成函数)\n   * @param logger - Optional logger instance (可选的日志实例)\n   */\n  constructor(\n    api: WindowManagerApi,\n    data: {\n      data: T & { winId?: string };\n      contentLoader?: (window: any, options: any) => Promise<void> | void;\n    },\n    creator: (options: WindowCreationOptions) => string | Promise<string>,\n    extraOptions?: (data: T) => object,\n    logger?: ILogger\n  ) {\n    this.api = api;\n    this.data = data;\n    this.winId = data?.data?.winId || '';\n    this.creator = creator;\n    this.extraOptions = extraOptions;\n    this.logger = logger || new Logger({ appName: 'WindowCreator' });\n  }\n\n  /**\n   * Internal method: Create window\n   * 内部方法：创建窗口\n   *\n   * Checks if window exists. If it exists but is destroyed, cleans up and recreates.\n   * 检查窗口是否存在。如果存在但已销毁，则清理并重新创建。\n   *\n   * @returns Object containing window ID and isNew flag (包含窗口 ID 和是否为新创建标志的对象)\n   */\n  private async createWindow(): Promise<{ winId: string; isNew: boolean }> {\n    let isNew = false;\n\n    // Check if window exists\n    // 检查窗口是否存在\n    if (this.winId && this.api.window.hasById(this.winId)) {\n      // If exists but destroyed, clean it up\n      // 如果存在但已销毁，进行清理\n      if (this.api.window.isDestroyed(this.winId)) {\n        this.logger.warn(\n          `Window ${this.winId} is found in store but destroyed. Cleaning up and recreating.`\n        );\n        // Clean up using the API which should handle both ID and Name maps if possible\n        // 使用 API 清理，应该同时处理 ID 和名称映射\n        await this.api.window.removeWindow(this.winId);\n      } else {\n        // Window exists and is valid\n        // 窗口存在且有效\n        return { winId: this.winId, isNew: false };\n      }\n    }\n\n    // Create new window instance\n    // 创建新窗口实例\n    const options = this.winId\n      ? {\n          windowId: this.winId,\n          ...(this.extraOptions?.(this.data.data) || {}),\n        }\n      : this.data.data;\n\n    this.winId = await this.creator(options);\n    isNew = true;\n\n    return { winId: this.winId, isNew };\n  }\n\n  /**\n   * Internal method: Show window\n   * 内部方法：显示窗口\n   *\n   * @param winId - Window ID (窗口 ID)\n   * @param isNew - Is newly created (是否为新创建)\n   */\n  private showWindow(winId: string, isNew: boolean): void {\n    const win = this.api.window.getTargetWindow(winId);\n\n    if (!win || win.isDestroyed()) {\n      this.logger.error(`Failed to show window ${winId}: Window not found or destroyed`);\n      return;\n    }\n\n    if (isNew) {\n      // For new windows, wait for ready-to-show to prevent flickering\n      // 对于新窗口，等待 ready-to-show 事件以防止闪烁\n      win.once('ready-to-show', () => {\n        this.api.window.show(win, winId);\n      });\n    } else {\n      // For existing windows, show immediately\n      // 对于现有窗口，立即显示\n      this.api.window.show(win, winId);\n    }\n  }\n\n  /**\n   * Internal method: Load content\n   * 内部方法：加载内容\n   */\n  private async loadContent(winId: string, options: WindowCreationOptions): Promise<void> {\n    const win = this.api.window.getTargetWindow(winId);\n    if (!win || win.isDestroyed()) return;\n\n    // Handle custom load handler\n    // 处理自定义加载处理程序\n    if (options.loadWindowContent) {\n      try {\n        await options.loadWindowContent(win);\n      } catch (e) {\n        this.logger.error(`Custom loadWindowContent failed for window ${winId}: ${e}`);\n      }\n      return;\n    }\n\n    if (this.data.contentLoader) {\n      try {\n        await this.data.contentLoader(win, options);\n      } catch (e) {\n        this.logger.error(`Global contentLoader failed for window ${winId}: ${e}`);\n      }\n      return;\n    }\n\n    if (options.loadUrl) {\n      win.loadURL(options.loadUrl).catch((e) => {\n        this.logger.error(`Failed to load URL \"${options.loadUrl}\" for window ${winId}: ${e}`);\n      });\n    } else if (options.loadFile) {\n      win.loadFile(options.loadFile).catch((e) => {\n        this.logger.error(`Failed to load file \"${options.loadFile}\" for window ${winId}: ${e}`);\n      });\n    }\n  }\n\n  /**\n   * Create and show window\n   * 创建并显示窗口\n   *\n   * If window exists, restores and focuses it. If not, creates it.\n   * 如果窗口已存在则恢复并聚焦，如果不存在则创建。\n   *\n   * @returns Window ID (窗口 ID)\n   */\n  public async createAndShow(): Promise<string> {\n    try {\n      const { isNew } = await this.createWindow();\n\n      // Load content if it's a new window\n      if (isNew) {\n        const options = this.winId\n          ? {\n              windowId: this.winId,\n              ...(this.extraOptions?.(this.data.data) || {}),\n            }\n          : this.data.data;\n        await this.loadContent(this.winId, options);\n      }\n\n      this.showWindow(this.winId, isNew);\n      return this.winId;\n    } catch (error) {\n      this.logger.error(`Failed to create and show window: ${error}`);\n      throw error;\n    }\n  }\n}\n"],"names":["Logger"],"mappings":"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"}

package/dist/core/window/WindowManager.d.ts

@@ -0,0 +1,214 @@
+import { BrowserWindow, BrowserWindowConstructorOptions } from 'electron';
+import { TypedEmitter } from 'tiny-typed-emitter';
+import { ILogger } from '@/infrastructure/logger';
+import WindowStore from './WindowStore';
+import type { WindowManagerConfig, WindowManagerPlugin, WindowCreationOptions, WindowManagerEvents } from './window-manager.type';
+import type IpcRouter from '@/core/ipc/IpcRouter';
+import type { IIpcTransport } from '@/core/ipc/transport/ipc.type';
+import type { MessageBus } from '@/core/message-bus/MessageBus';
+import { IpcSetup } from './IpcSetup';
+import { MetricsManager } from './core/MetricsManager';
+import { PluginExecutor } from './core/PluginExecutor';
+import { WindowLifecycle } from './core/WindowLifecycle';
+/**
+ * WindowManager - Core class for managing Electron windows
+ * WindowManager - 管理 Electron 窗口的核心类
+ *
+ * Uses WindowStore via composition to handle window management
+ * 使用组合方式通过 WindowStore 处理窗口管理
+ */
+export default class WindowManager extends TypedEmitter<WindowManagerEvents> {
+    config: WindowManagerConfig;
+    ipcRouter?: IpcRouter;
+    ipcTransport?: IIpcTransport;
+    messageBus?: MessageBus;
+    protected currentIpcChannel: string | null;
+    protected currentIpcSyncChannel: string | null;
+    logger: ILogger;
+    readonly windowStore: WindowStore;
+    protected metricsManager: MetricsManager;
+    protected pluginExecutor: PluginExecutor;
+    protected lifecycle: WindowLifecycle;
+    private isInitialized;
+    private initPromise;
+    private initError;
+    /**
+     * Constructor
+     * 构造函数
+     * @param config - WindowManager configuration
+     */
+    constructor(config?: WindowManagerConfig);
+    /**
+     * Returns a promise that resolves when initialization is complete
+     * 返回一个 Promise，当初始化完成时 resolve
+     * @throws {Error} If initialization failed
+     */
+    ready(): Promise<void>;
+    /**
+     * Check if WindowManager is initialized
+     * 检查 WindowManager 是否已初始化
+     */
+    get initialized(): boolean;
+    /**
+     * Get initialization error if any
+     * 获取初始化错误（如果有）
+     */
+    get initializationError(): Error | null;
+    /**
+     * Initialize plugins
+     * 初始化插件
+     */
+    private init;
+    /**
+     * Register a plugin
+     * 注册插件
+     * @param plugin - Plugin instance
+     */
+    use(plugin: WindowManagerPlugin): this;
+    /**
+     * Setup IPC communication
+     * 设置 IPC 通信
+     * @param options - Optional IPC configuration (可选的 IPC 配置)
+     */
+    setupIPC(options?: {
+        channel?: string;
+        syncChannel?: string;
+        setupImpl?: typeof IpcSetup.setup;
+    }): void;
+    /**
+     * Create a new window
+     * 创建一个新窗口
+     * @param config - Configuration object (配置对象)
+     * @returns Window ID (窗口 ID)
+     */
+    create(config?: WindowCreationOptions): Promise<string>;
+    /**
+     * Remove window
+     * 移除窗口
+     * @param windowId - Window ID
+     */
+    removeWindow(windowId: string): Promise<void>;
+    /**
+     * Get performance metrics
+     * 获取性能指标
+     * @returns Performance metrics object
+     */
+    getMetrics(): import("./core/MetricsManager").WindowManagerMetricsData;
+    /**
+     * Dispose all resources
+     * 释放所有资源
+     */
+    dispose(): void;
+    private getMainWindowId;
+    createBrowserWindow(config?: BrowserWindowConstructorOptions): BrowserWindow;
+    protected getDefaultWindowConfig(): BrowserWindowConstructorOptions;
+    configureWindowBehavior(window: BrowserWindow, windowId: string): void;
+    /**
+     * Join a window to a group
+     * 将窗口加入组
+     */
+    joinGroup(windowId: string, group: string): void;
+    /**
+     * Leave a window from a group
+     * 将窗口移出组
+     */
+    leaveGroup(windowId: string, group: string): void;
+    /**
+     * Get all window IDs in a group
+     * 获取组内所有窗口 ID
+     */
+    getGroup(group: string): string[];
+    /**
+     * Close all windows in a group
+     * 关闭组内所有窗口
+     */
+    closeGroup(group: string): Promise<void>;
+    /**
+     * Hide all windows in a group
+     * 隐藏组内所有窗口
+     */
+    hideGroup(group: string): void;
+    /**
+     * Show all windows in a group
+     * 显示组内所有窗口
+     */
+    showGroup(group: string): void;
+    /**
+     * Focus all windows in a group
+     * 聚焦组内所有窗口
+     */
+    focusGroup(group: string): void;
+    /**
+     * Send message to all windows in a group via MessageBus
+     * 通过 MessageBus 向组内所有窗口发送消息
+     * @param group - Group name (组名)
+     * @param channel - Channel name (频道名称)
+     * @param data - Message data (消息数据)
+     * @returns Number of successful sends (成功发送的数量)
+     */
+    sendToGroup(group: string, channel: string, data: any): number;
+    /**
+     * Focus previous window in history
+     * 聚焦历史记录中的上一个窗口
+     */
+    focusPrevious(): void;
+    validateWindowId(windowId: string | undefined | null, methodName: string): string;
+    show(window: BrowserWindow, windowId?: string): void;
+    hide(windowId: string): void;
+    isDestroyed(windowId: string): boolean;
+    isVisible(windowId: string): boolean;
+    isMinimized(windowId: string): boolean;
+    isMaximized(windowId: string): boolean;
+    fullScreenState(windowId: string): boolean;
+    minimize(windowId?: string): void;
+    restore(windowId: string): void;
+    maximize(windowId: string): void;
+    unmaximize(windowId: string): void;
+    fullScreen(windowId: string): void;
+    focus(windowId: string): void;
+    setMovable(window: BrowserWindow): void;
+    /**
+     * Close a window
+     * 关闭窗口
+     * @param windowId - Window ID (窗口 ID)
+     */
+    close(windowId: string): void;
+    /**
+     * @deprecated Use close() instead
+     * @deprecated 使用 close() 代替
+     */
+    winClose(windowId: string): void;
+    openDevTools(windowId: string): void;
+    isDevToolsOpened(windowId: string): boolean;
+    closeDevTools(windowId: string): void;
+    quit(): void;
+    getWindowSize(): {
+        width: number;
+        height: number;
+    };
+    send(windowId: string, name: string, data?: unknown): void;
+    setSkipTaskbar(windowId: string, bool: boolean): void;
+    get mainWindow(): BrowserWindow | null;
+    getWindowCount(): number;
+    getAllWindowKeys(): string[];
+    getAllWindows(): BrowserWindow[];
+    getWindowNames(): Map<string, string>;
+    getNameByWindowId(windowId: string): string | undefined;
+    getWindowByNameId(name: string): string | undefined;
+    getWindowByName(name: string): BrowserWindow | undefined;
+    hasByName(proposedName: string): boolean;
+    deleteByName(proposedName: string): boolean;
+    getWindowById(windowId: string): BrowserWindow | undefined;
+    hasById(windowId: string): boolean;
+    deleteById(windowId: string): boolean;
+    getWindowId(window: BrowserWindow): string | undefined;
+    updateWindowName(windowId: string, newName: string): void;
+    getTargetWindow(windowId?: string): BrowserWindow | undefined;
+    getValidWindow(windowId?: string): BrowserWindow | undefined;
+    getCurrentWindow(): BrowserWindow | undefined;
+    saveWindowContext(windowId: string, context: any): Promise<void>;
+    loadWindowContext(windowId: string): Promise<any>;
+    clearWindowContext(windowId: string): Promise<void>;
+    startCleanupProtection(intervalMs?: number): void;
+    stopCleanupProtection(): void;
+}