electron-infra-kit 0.0.2

package/dist/internal/utils/StateKeeper.mjs

@@ -0,0 +1,334 @@
+import {app,screen}from'electron';import*as fs from'fs';import*as path from'path';import*as crypto from'crypto';import {ElectronLogger}from'../../infrastructure/logger/ElectronLogger.mjs';/**
+ * StateKeeper.ts
+ * 窗口状态管理器，负责持久化和恢复 Electron 窗口的位置、大小等状态
+ *
+ * 主要功能：
+ * - 保存窗口状态到文件系统
+ * - 从文件系统加载窗口状态
+ * - 验证窗口状态的有效性（确保窗口在可用显示器范围内）
+ * - 支持延迟保存机制，避免频繁 IO 操作
+ */
+/**
+ * 简单的深度对比函数，用于检查窗口状态是否发生变化
+ */
+function isStateEqual(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    // Check groups equality
+    const groupsA = a.groups || [];
+    const groupsB = b.groups || [];
+    const groupsEqual = groupsA.length === groupsB.length &&
+        [...groupsA].sort().every((val, index) => val === [...groupsB].sort()[index]);
+    return (a.x === b.x &&
+        a.y === b.y &&
+        a.width === b.width &&
+        a.height === b.height &&
+        a.isMaximized === b.isMaximized &&
+        a.isFullScreen === b.isFullScreen &&
+        groupsEqual &&
+        // 比较 displayBounds
+        ((!a.displayBounds && !b.displayBounds) ||
+            (!!a.displayBounds &&
+                !!b.displayBounds &&
+                a.displayBounds.x === b.displayBounds.x &&
+                a.displayBounds.y === b.displayBounds.y &&
+                a.displayBounds.width === b.displayBounds.width &&
+                a.displayBounds.height === b.displayBounds.height)));
+}
+/**
+ * 窗口状态管理器类
+ * 实现了窗口状态的持久化存储和加载功能
+ */
+class StateKeeper {
+    stateFile; // 状态文件路径
+    state = {}; // 存储所有窗口的状态
+    logger; // 日志记录器
+    saveTimer = null; // 延迟保存计时器
+    throttleLastSave = 0; // 节流模式下上次保存时间
+    saveDelay; // 延迟保存时间（毫秒）
+    saveStrategy; // 保存策略
+    // Track active state files to prevent multiple instances writing to the same file
+    // 跟踪活动的 State 文件，防止多个实例写入同一个文件
+    static activeFiles = new Set();
+    hasLock = false;
+    isWriting = false;
+    pendingWrite = false;
+    lastSavedHash = '';
+    /**
+     * 构造函数
+     * @param options 配置选项
+     */
+    constructor(options = {}) {
+        // 初始化日志记录器
+        this.logger = options.logger || new ElectronLogger({ appName: 'StateKeeper' });
+        // 初始化配置
+        this.saveDelay = options.saveDelay ?? 500;
+        this.saveStrategy = options.saveStrategy ?? 'debounce';
+        // 获取应用程序的数据目录
+        const userDataDir = app.getPath('userData');
+        // 设置状态文件路径
+        this.stateFile = options.stateFilePath || path.join(userDataDir, 'window-state.json');
+        // Check if file is already being used by another instance
+        // 检查文件是否已被另一个实例使用
+        if (StateKeeper.activeFiles.has(this.stateFile)) {
+            this.logger.warn(`State file "${this.stateFile}" is already in use by another StateKeeper instance. This may lead to data conflicts.`);
+            this.hasLock = false;
+        }
+        else {
+            StateKeeper.activeFiles.add(this.stateFile);
+            this.hasLock = true;
+        }
+        // 加载已保存的窗口状态
+        this.loadState();
+        // 监听 app 退出事件，强制保存
+        app.on('before-quit', () => {
+            this.flushSync();
+        });
+    }
+    /**
+     * 从文件加载窗口状态
+     * 私有方法，仅在构造函数中调用
+     */
+    loadState() {
+        try {
+            // 检查状态文件是否存在
+            if (fs.existsSync(this.stateFile)) {
+                // 读取文件内容
+                const data = fs.readFileSync(this.stateFile, 'utf-8');
+                // 解析 JSON 数据到状态对象
+                this.state = JSON.parse(data);
+                // Calculate initial hash
+                this.lastSavedHash = crypto.createHash('md5').update(data).digest('hex');
+            }
+        }
+        catch (error) {
+            // 加载失败时记录错误并初始化空状态
+            this.logger.error(`Failed to load window state: ${error}`);
+            this.state = {};
+        }
+    }
+    /**
+     * 保存指定窗口的状态
+     * @param windowName 窗口名称，用于标识不同窗口的状态
+     * @param windowState 窗口状态对象
+     */
+    saveState(windowName, windowState) {
+        // 1. Dirty Check (脏检查)
+        // 如果新状态与当前保存的状态一致，则跳过保存
+        const currentState = this.state[windowName];
+        if (isStateEqual(currentState, windowState)) {
+            return;
+        }
+        // 更新内存中的窗口状态
+        this.state[windowName] = windowState;
+        // 触发持久化操作（带延迟）
+        this.persist();
+    }
+    /**
+     * 立即同步保存状态（不使用延迟）
+     */
+    flushSync() {
+        if (this.saveTimer) {
+            clearTimeout(this.saveTimer);
+            this.saveTimer = null;
+        }
+        try {
+            fs.writeFileSync(this.stateFile, JSON.stringify(this.state, null, 2));
+        }
+        catch (error) {
+            this.logger.error(`Failed to flush window state: ${error}`);
+        }
+    }
+    /**
+     * 将内存中的状态持久化到文件
+     * 私有方法，使用延迟保存机制避免频繁 IO 操作
+     */
+    persist() {
+        if (this.saveStrategy === 'throttle') {
+            // 节流模式：在指定时间内只保存一次
+            const now = Date.now();
+            const timeSinceLastSave = now - this.throttleLastSave;
+            if (timeSinceLastSave >= this.saveDelay) {
+                // 立即保存
+                this.performSave();
+                this.throttleLastSave = now;
+            }
+            else {
+                // 安排在剩余时间后保存
+                if (this.saveTimer) {
+                    clearTimeout(this.saveTimer);
+                }
+                this.saveTimer = setTimeout(() => {
+                    this.performSave();
+                    this.throttleLastSave = Date.now();
+                }, this.saveDelay - timeSinceLastSave);
+            }
+        }
+        else {
+            // 防抖模式（默认）：重置计时器
+            if (this.saveTimer) {
+                clearTimeout(this.saveTimer);
+            }
+            this.saveTimer = setTimeout(() => {
+                this.performSave();
+            }, this.saveDelay);
+        }
+    }
+    /**
+     * 执行实际的保存操作
+     * 私有方法
+     */
+    async performSave() {
+        // If already writing, mark pending and return
+        // 如果正在写入，标记为等待写入并返回
+        if (this.isWriting) {
+            this.pendingWrite = true;
+            return;
+        }
+        this.isWriting = true;
+        const tempFile = `${this.stateFile}.tmp`; // 临时文件路径
+        try {
+            const data = JSON.stringify(this.state, null, 2);
+            // Optimization: Check if data has actually changed using MD5 hash
+            // 优化：使用 MD5 哈希检查数据是否实际发生变化
+            const currentHash = crypto.createHash('md5').update(data).digest('hex');
+            if (currentHash === this.lastSavedHash) {
+                // No changes, skip write
+                this.isWriting = false;
+                return;
+            }
+            // 1. Write to temporary file first (Atomic Write Step 1)
+            // 先写入临时文件（原子写入步骤 1）
+            await fs.promises.writeFile(tempFile, data);
+            // 2. Rename temporary file to actual file (Atomic Write Step 2)
+            // 重命名临时文件为实际文件（原子写入步骤 2）
+            // This operation is atomic on most file systems
+            // 此操作在大多数文件系统上是原子的
+            await fs.promises.rename(tempFile, this.stateFile);
+            this.lastSavedHash = currentHash;
+        }
+        catch (error) {
+            this.logger.error(`Failed to save window state: ${error}`);
+            // Cleanup: Try to delete the temp file if it exists
+            // 清理：如果临时文件存在，尝试删除
+            try {
+                await fs.promises.unlink(tempFile);
+            }
+            catch (cleanupError) {
+                // Ignore cleanup errors (e.g. file not found)
+                // 忽略清理错误（例如文件未找到）
+            }
+        }
+        finally {
+            this.saveTimer = null;
+            this.isWriting = false;
+            // If a write was requested while writing, trigger another save immediately
+            // 如果在写入期间请求了写入，立即触发另一次保存
+            if (this.pendingWrite) {
+                this.pendingWrite = false;
+                // Use setImmediate to break the call stack and allow other events
+                // 使用 setImmediate 打断调用栈并允许处理其他事件
+                setImmediate(() => this.performSave());
+            }
+        }
+    }
+    /**
+     * 获取指定窗口的状态
+     * @param windowName 窗口名称
+     * @param defaultWidth 默认宽度，当没有保存状态或状态无效时使用
+     * @param defaultHeight 默认高度，当没有保存状态或状态无效时使用
+     * @returns 窗口状态对象
+     */
+    getWindowState(windowName, defaultWidth = 800, defaultHeight = 600) {
+        // 获取保存的窗口状态
+        const savedState = this.state[windowName];
+        // 如果没有保存的状态，返回默认状态
+        if (!savedState) {
+            return {
+                width: defaultWidth,
+                height: defaultHeight,
+                isMaximized: false,
+                isFullScreen: false,
+            };
+        }
+        // 验证保存的状态是否有效
+        if (!this.isValidState(savedState)) {
+            // 如果状态无效，返回默认状态
+            return {
+                width: defaultWidth,
+                height: defaultHeight,
+                isMaximized: false,
+                isFullScreen: false,
+            };
+        }
+        // 返回有效的保存状态
+        return savedState;
+    }
+    /**
+     * 验证窗口状态是否有效
+     * 主要检查窗口是否在当前可用显示器范围内
+     * @param state 要验证的窗口状态
+     * @returns 状态是否有效
+     */
+    isValidState(state) {
+        // 获取所有可用显示器
+        const displays = screen.getAllDisplays();
+        // 优先检查保存的显示器信息是否与当前显示器匹配
+        if (state.displayBounds) {
+            const displayMatch = displays.find((d) => {
+                // 精确匹配显示器边界
+                return (d.bounds.x === state.displayBounds?.x &&
+                    d.bounds.y === state.displayBounds?.y &&
+                    d.bounds.width === state.displayBounds?.width &&
+                    d.bounds.height === state.displayBounds?.height);
+            });
+            if (displayMatch) {
+                // 如果找到完全匹配的显示器，并且窗口有坐标信息，则认为状态有效
+                if (state.x !== undefined && state.y !== undefined) {
+                    return true;
+                }
+            }
+        }
+        // 降级验证：检查窗口是否与任何显示器相交
+        const isVisible = displays.some((display) => {
+            const { x, y, width, height } = display.bounds;
+            // 如果窗口没有坐标信息，使用默认值 0
+            const wx = state.x || 0;
+            const wy = state.y || 0;
+            const ww = state.width;
+            const wh = state.height;
+            // 简单的矩形相交检查
+            return wx < x + width && wx + ww > x && wy < y + height && wy + wh > y;
+        });
+        return isVisible;
+    }
+    /**
+     * 移除指定窗口的状态
+     * @param windowName 窗口名称
+     */
+    removeState(windowName) {
+        // 检查是否存在该窗口的状态
+        if (this.state[windowName]) {
+            // 从内存中删除窗口状态
+            delete this.state[windowName];
+            // 触发持久化操作
+            this.persist();
+        }
+    }
+    /**
+     * Dispose StateKeeper instance
+     * 释放 StateKeeper 实例
+     */
+    dispose() {
+        if (this.saveTimer) {
+            clearTimeout(this.saveTimer);
+            this.saveTimer = null;
+        }
+        // Only remove from activeFiles if this instance acquired the lock
+        if (this.hasLock) {
+            StateKeeper.activeFiles.delete(this.stateFile);
+        }
+    }
+}export{StateKeeper as default};//# sourceMappingURL=StateKeeper.mjs.map

package/dist/internal/utils/StateKeeper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateKeeper.mjs","sources":["../../../src/internal/utils/StateKeeper.ts"],"sourcesContent":["/**\n * StateKeeper.ts\n * 窗口状态管理器，负责持久化和恢复 Electron 窗口的位置、大小等状态\n *\n * 主要功能：\n * - 保存窗口状态到文件系统\n * - 从文件系统加载窗口状态\n * - 验证窗口状态的有效性（确保窗口在可用显示器范围内）\n * - 支持延迟保存机制，避免频繁 IO 操作\n */\n\nimport { app, screen } from 'electron';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as crypto from 'crypto';\nimport { Logger, ILogger } from '@/infrastructure/logger';\n\n/**\n * 窗口状态接口，定义了需要持久化的窗口属性\n */\nexport interface WindowState {\n  x?: number; // 窗口左上角 X 坐标\n  y?: number; // 窗口左上角 Y 坐标\n  width: number; // 窗口宽度\n  height: number; // 窗口高度\n  isMaximized: boolean; // 是否最大化\n  isFullScreen: boolean; // 是否全屏\n  displayBounds?: Electron.Rectangle; // 显示该窗口的显示器边界信息\n  groups?: string[]; // 窗口所属的组\n}\n\n/**\n * StateKeeper Configuration Options\n * StateKeeper 配置选项\n */\nexport interface StateKeeperOptions {\n  /**\n   * Delay before saving state to disk (in milliseconds)\n   * 保存状态到磁盘前的延迟时间（毫秒）\n   * @default 500\n   */\n  saveDelay?: number;\n\n  /**\n   * Save strategy: 'debounce' or 'throttle'\n   * 保存策略：'debounce'（防抖）或 'throttle'（节流）\n   * @default 'debounce'\n   */\n  saveStrategy?: 'debounce' | 'throttle';\n\n  /**\n   * Custom logger instance\n   * 自定义日志实例\n   */\n  logger?: ILogger;\n\n  /**\n   * Custom state file path\n   * 自定义状态文件路径\n   */\n  stateFilePath?: string;\n}\n\n/**\n * 简单的深度对比函数，用于检查窗口状态是否发生变化\n */\nfunction isStateEqual(a: WindowState | undefined, b: WindowState | undefined): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n\n  // Check groups equality\n  const groupsA = a.groups || [];\n  const groupsB = b.groups || [];\n  const groupsEqual =\n    groupsA.length === groupsB.length &&\n    [...groupsA].sort().every((val, index) => val === [...groupsB].sort()[index]);\n\n  return (\n    a.x === b.x &&\n    a.y === b.y &&\n    a.width === b.width &&\n    a.height === b.height &&\n    a.isMaximized === b.isMaximized &&\n    a.isFullScreen === b.isFullScreen &&\n    groupsEqual &&\n    // 比较 displayBounds\n    ((!a.displayBounds && !b.displayBounds) ||\n      (!!a.displayBounds &&\n        !!b.displayBounds &&\n        a.displayBounds.x === b.displayBounds.x &&\n        a.displayBounds.y === b.displayBounds.y &&\n        a.displayBounds.width === b.displayBounds.width &&\n        a.displayBounds.height === b.displayBounds.height))\n  );\n}\n\n/**\n * 窗口状态管理器类\n * 实现了窗口状态的持久化存储和加载功能\n */\nexport default class StateKeeper {\n  private stateFile: string; // 状态文件路径\n  private state: Record<string, WindowState> = {}; // 存储所有窗口的状态\n  private logger: ILogger; // 日志记录器\n\n  private saveTimer: NodeJS.Timeout | null = null; // 延迟保存计时器\n  private throttleLastSave: number = 0; // 节流模式下上次保存时间\n  private readonly saveDelay: number; // 延迟保存时间（毫秒）\n  private readonly saveStrategy: 'debounce' | 'throttle'; // 保存策略\n\n  // Track active state files to prevent multiple instances writing to the same file\n  // 跟踪活动的 State 文件，防止多个实例写入同一个文件\n  private static activeFiles: Set<string> = new Set();\n  private hasLock: boolean = false;\n  private isWriting: boolean = false;\n  private pendingWrite: boolean = false;\n  private lastSavedHash: string = '';\n\n  /**\n   * 构造函数\n   * @param options 配置选项\n   */\n  constructor(options: StateKeeperOptions = {}) {\n    // 初始化日志记录器\n    this.logger = options.logger || new Logger({ appName: 'StateKeeper' });\n\n    // 初始化配置\n    this.saveDelay = options.saveDelay ?? 500;\n    this.saveStrategy = options.saveStrategy ?? 'debounce';\n\n    // 获取应用程序的数据目录\n    const userDataDir = app.getPath('userData');\n    // 设置状态文件路径\n    this.stateFile = options.stateFilePath || path.join(userDataDir, 'window-state.json');\n\n    // Check if file is already being used by another instance\n    // 检查文件是否已被另一个实例使用\n    if (StateKeeper.activeFiles.has(this.stateFile)) {\n      this.logger.warn(\n        `State file \"${this.stateFile}\" is already in use by another StateKeeper instance. This may lead to data conflicts.`\n      );\n      this.hasLock = false;\n    } else {\n      StateKeeper.activeFiles.add(this.stateFile);\n      this.hasLock = true;\n    }\n\n    // 加载已保存的窗口状态\n    this.loadState();\n\n    // 监听 app 退出事件，强制保存\n    app.on('before-quit', () => {\n      this.flushSync();\n    });\n  }\n\n  /**\n   * 从文件加载窗口状态\n   * 私有方法，仅在构造函数中调用\n   */\n  private loadState(): void {\n    try {\n      // 检查状态文件是否存在\n      if (fs.existsSync(this.stateFile)) {\n        // 读取文件内容\n        const data = fs.readFileSync(this.stateFile, 'utf-8');\n        // 解析 JSON 数据到状态对象\n        this.state = JSON.parse(data);\n        // Calculate initial hash\n        this.lastSavedHash = crypto.createHash('md5').update(data).digest('hex');\n      }\n    } catch (error) {\n      // 加载失败时记录错误并初始化空状态\n      this.logger.error(`Failed to load window state: ${error}`);\n      this.state = {};\n    }\n  }\n\n  /**\n   * 保存指定窗口的状态\n   * @param windowName 窗口名称，用于标识不同窗口的状态\n   * @param windowState 窗口状态对象\n   */\n  public saveState(windowName: string, windowState: WindowState): void {\n    // 1. Dirty Check (脏检查)\n    // 如果新状态与当前保存的状态一致，则跳过保存\n    const currentState = this.state[windowName];\n    if (isStateEqual(currentState, windowState)) {\n      return;\n    }\n\n    // 更新内存中的窗口状态\n    this.state[windowName] = windowState;\n    // 触发持久化操作（带延迟）\n    this.persist();\n  }\n\n  /**\n   * 立即同步保存状态（不使用延迟）\n   */\n  public flushSync(): void {\n    if (this.saveTimer) {\n      clearTimeout(this.saveTimer);\n      this.saveTimer = null;\n    }\n\n    try {\n      fs.writeFileSync(this.stateFile, JSON.stringify(this.state, null, 2));\n    } catch (error) {\n      this.logger.error(`Failed to flush window state: ${error}`);\n    }\n  }\n\n  /**\n   * 将内存中的状态持久化到文件\n   * 私有方法，使用延迟保存机制避免频繁 IO 操作\n   */\n  private persist(): void {\n    if (this.saveStrategy === 'throttle') {\n      // 节流模式：在指定时间内只保存一次\n      const now = Date.now();\n      const timeSinceLastSave = now - this.throttleLastSave;\n\n      if (timeSinceLastSave >= this.saveDelay) {\n        // 立即保存\n        this.performSave();\n        this.throttleLastSave = now;\n      } else {\n        // 安排在剩余时间后保存\n        if (this.saveTimer) {\n          clearTimeout(this.saveTimer);\n        }\n        this.saveTimer = setTimeout(() => {\n          this.performSave();\n          this.throttleLastSave = Date.now();\n        }, this.saveDelay - timeSinceLastSave);\n      }\n    } else {\n      // 防抖模式（默认）：重置计时器\n      if (this.saveTimer) {\n        clearTimeout(this.saveTimer);\n      }\n\n      this.saveTimer = setTimeout(() => {\n        this.performSave();\n      }, this.saveDelay);\n    }\n  }\n\n  /**\n   * 执行实际的保存操作\n   * 私有方法\n   */\n  private async performSave(): Promise<void> {\n    // If already writing, mark pending and return\n    // 如果正在写入，标记为等待写入并返回\n    if (this.isWriting) {\n      this.pendingWrite = true;\n      return;\n    }\n\n    this.isWriting = true;\n    const tempFile = `${this.stateFile}.tmp`; // 临时文件路径\n\n    try {\n      const data = JSON.stringify(this.state, null, 2);\n\n      // Optimization: Check if data has actually changed using MD5 hash\n      // 优化：使用 MD5 哈希检查数据是否实际发生变化\n      const currentHash = crypto.createHash('md5').update(data).digest('hex');\n      if (currentHash === this.lastSavedHash) {\n        // No changes, skip write\n        this.isWriting = false;\n        return;\n      }\n\n      // 1. Write to temporary file first (Atomic Write Step 1)\n      // 先写入临时文件（原子写入步骤 1）\n      await fs.promises.writeFile(tempFile, data);\n\n      // 2. Rename temporary file to actual file (Atomic Write Step 2)\n      // 重命名临时文件为实际文件（原子写入步骤 2）\n      // This operation is atomic on most file systems\n      // 此操作在大多数文件系统上是原子的\n      await fs.promises.rename(tempFile, this.stateFile);\n\n      this.lastSavedHash = currentHash;\n    } catch (error) {\n      this.logger.error(`Failed to save window state: ${error}`);\n\n      // Cleanup: Try to delete the temp file if it exists\n      // 清理：如果临时文件存在，尝试删除\n      try {\n        await fs.promises.unlink(tempFile);\n      } catch (cleanupError) {\n        // Ignore cleanup errors (e.g. file not found)\n        // 忽略清理错误（例如文件未找到）\n      }\n    } finally {\n      this.saveTimer = null;\n      this.isWriting = false;\n\n      // If a write was requested while writing, trigger another save immediately\n      // 如果在写入期间请求了写入，立即触发另一次保存\n      if (this.pendingWrite) {\n        this.pendingWrite = false;\n        // Use setImmediate to break the call stack and allow other events\n        // 使用 setImmediate 打断调用栈并允许处理其他事件\n        setImmediate(() => this.performSave());\n      }\n    }\n  }\n\n  /**\n   * 获取指定窗口的状态\n   * @param windowName 窗口名称\n   * @param defaultWidth 默认宽度，当没有保存状态或状态无效时使用\n   * @param defaultHeight 默认高度，当没有保存状态或状态无效时使用\n   * @returns 窗口状态对象\n   */\n  public getWindowState(\n    windowName: string,\n    defaultWidth: number = 800,\n    defaultHeight: number = 600\n  ): WindowState {\n    // 获取保存的窗口状态\n    const savedState = this.state[windowName];\n    // 如果没有保存的状态，返回默认状态\n    if (!savedState) {\n      return {\n        width: defaultWidth,\n        height: defaultHeight,\n        isMaximized: false,\n        isFullScreen: false,\n      };\n    }\n\n    // 验证保存的状态是否有效\n    if (!this.isValidState(savedState)) {\n      // 如果状态无效，返回默认状态\n      return {\n        width: defaultWidth,\n        height: defaultHeight,\n        isMaximized: false,\n        isFullScreen: false,\n      };\n    }\n\n    // 返回有效的保存状态\n    return savedState;\n  }\n\n  /**\n   * 验证窗口状态是否有效\n   * 主要检查窗口是否在当前可用显示器范围内\n   * @param state 要验证的窗口状态\n   * @returns 状态是否有效\n   */\n  private isValidState(state: WindowState): boolean {\n    // 获取所有可用显示器\n    const displays = screen.getAllDisplays();\n\n    // 优先检查保存的显示器信息是否与当前显示器匹配\n    if (state.displayBounds) {\n      const displayMatch = displays.find((d) => {\n        // 精确匹配显示器边界\n        return (\n          d.bounds.x === state.displayBounds?.x &&\n          d.bounds.y === state.displayBounds?.y &&\n          d.bounds.width === state.displayBounds?.width &&\n          d.bounds.height === state.displayBounds?.height\n        );\n      });\n\n      if (displayMatch) {\n        // 如果找到完全匹配的显示器，并且窗口有坐标信息，则认为状态有效\n        if (state.x !== undefined && state.y !== undefined) {\n          return true;\n        }\n      }\n    }\n\n    // 降级验证：检查窗口是否与任何显示器相交\n    const isVisible = displays.some((display) => {\n      const { x, y, width, height } = display.bounds;\n      // 如果窗口没有坐标信息，使用默认值 0\n      const wx = state.x || 0;\n      const wy = state.y || 0;\n      const ww = state.width;\n      const wh = state.height;\n\n      // 简单的矩形相交检查\n      return wx < x + width && wx + ww > x && wy < y + height && wy + wh > y;\n    });\n\n    return isVisible;\n  }\n\n  /**\n   * 移除指定窗口的状态\n   * @param windowName 窗口名称\n   */\n  public removeState(windowName: string): void {\n    // 检查是否存在该窗口的状态\n    if (this.state[windowName]) {\n      // 从内存中删除窗口状态\n      delete this.state[windowName];\n      // 触发持久化操作\n      this.persist();\n    }\n  }\n\n  /**\n   * Dispose StateKeeper instance\n   * 释放 StateKeeper 实例\n   */\n  public dispose(): void {\n    if (this.saveTimer) {\n      clearTimeout(this.saveTimer);\n      this.saveTimer = null;\n    }\n    // Only remove from activeFiles if this instance acquired the lock\n    if (this.hasLock) {\n      StateKeeper.activeFiles.delete(this.stateFile);\n    }\n  }\n}\n"],"names":["Logger"],"mappings":"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"}

package/dist/internal/utils/branded-helpers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Branded Type Helpers
+ * 品牌类型辅助函数
+ *
+ * Utility functions for creating and validating branded types
+ * 用于创建和验证品牌类型的工具函数
+ */
+import type { WindowId, EventName, ChannelName, HandlerName, FieldKey } from '@/internal/types/branded';
+/**
+ * Create a WindowId from a string with validation
+ * 从字符串创建 WindowId (带验证)
+ */
+export declare function createWindowId(id: string): WindowId;
+/**
+ * Create an EventName from a string with validation
+ * 从字符串创建 EventName (带验证)
+ */
+export declare function createEventName(name: string): EventName;
+/**
+ * Create a ChannelName from a string with validation
+ * 从字符串创建 ChannelName (带验证)
+ */
+export declare function createChannelName(name: string): ChannelName;
+/**
+ * Create a HandlerName from a string with validation
+ * 从字符串创建 HandlerName (带验证)
+ */
+export declare function createHandlerName(name: string): HandlerName;
+/**
+ * Create a FieldKey from a string with validation
+ * 从字符串创建 FieldKey (带验证)
+ */
+export declare function createFieldKey(key: string): FieldKey;

package/dist/internal/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { default as StateKeeper } from './StateKeeper';
+export { MessageDispatcher } from './MessageDispatcher';
+export * from './branded-helpers';
+export * from './RateLimiter';
+export declare const delay: (time: number) => Promise<void>;

package/dist/preload/index.d.ts

@@ -0,0 +1,45 @@
+import { IpcRendererBindings, PreloadConfig } from './preload.type';
+export * from './preload.type';
+/**
+ * IpcRendererBridge - Secure IPC Bridge for Renderer Process
+ * IpcRendererBridge - 渲染进程的安全 IPC 桥接器
+ */
+export declare class IpcRendererBridge {
+    private bindings;
+    private channel;
+    private syncChannel;
+    constructor();
+    /**
+     * Configure the IPC channels
+     * 配置 IPC 频道
+     * @param config - The configuration object
+     */
+    configure(config: PreloadConfig): void;
+    /**
+     * Send an asynchronous message to the main process
+     * 发送异步消息到主进程
+     * @param name - Handler name (处理器名称)
+     * @param payload - Data payload (数据负载)
+     */
+    private invoke;
+    /**
+     * Send a synchronous message to the main process
+     * 发送同步消息到主进程
+     * @param name - Handler name (处理器名称)
+     * @param payload - Data payload (数据负载)
+     */
+    private sendSync;
+    /**
+     * Get the bindings object
+     * 获取绑定对象
+     */
+    getBindings(): IpcRendererBindings;
+    /**
+     * Expose API to the main world using contextBridge
+     * 使用 contextBridge 将 API 暴露给主世界
+     * @param apiKey - The key to expose on window object (default: 'ipcApi')
+     */
+    exposeApi(apiKey?: string): void;
+}
+declare const ipcRendererBridge: IpcRendererBridge;
+export { ipcRendererBridge };

package/dist/preload/index.js

@@ -0,0 +1,91 @@
+'use strict';var electron=require('electron'),constants=require('../core/window/constants.js');/**
+ * IpcRendererBridge - Secure IPC Bridge for Renderer Process
+ * IpcRendererBridge - 渲染进程的安全 IPC 桥接器
+ */
+class IpcRendererBridge {
+    bindings;
+    channel = constants.IPC_CHANNELS.RENDERER_TO_MAIN;
+    syncChannel = constants.IPC_CHANNELS.RENDERER_TO_MAIN_SYNC;
+    constructor() {
+        this.bindings = {
+            invoke: this.invoke.bind(this),
+            sendSync: this.sendSync.bind(this),
+        };
+    }
+    /**
+     * Configure the IPC channels
+     * 配置 IPC 频道
+     * @param config - The configuration object
+     */
+    configure(config) {
+        if (config.channel) {
+            this.channel = config.channel;
+        }
+        if (config.syncChannel) {
+            this.syncChannel = config.syncChannel;
+        }
+    }
+    /**
+     * Send an asynchronous message to the main process
+     * 发送异步消息到主进程
+     * @param name - Handler name (处理器名称)
+     * @param payload - Data payload (数据负载)
+     */
+    invoke = async (name, payload) => {
+        const response = await electron.ipcRenderer.invoke(this.channel, {
+            name,
+            payload,
+        });
+        // Automatic unwrapping of standard response format
+        // 自动解包标准响应格式
+        if (response && typeof response === 'object' && 'code' in response) {
+            if (response.code === 0) {
+                return response.data;
+            }
+            throw new Error(response.message || `IPC Error: ${response.code}`);
+        }
+        return response;
+    };
+    /**
+     * Send a synchronous message to the main process
+     * 发送同步消息到主进程
+     * @param name - Handler name (处理器名称)
+     * @param payload - Data payload (数据负载)
+     */
+    sendSync = (name, payload) => {
+        const response = electron.ipcRenderer.sendSync(this.syncChannel, {
+            name,
+            payload,
+        });
+        // Automatic unwrapping of standard response format
+        // 自动解包标准响应格式
+        if (response && typeof response === 'object' && 'code' in response) {
+            if (response.code === 0) {
+                return response.data;
+            }
+            throw new Error(response.message || `IPC Error: ${response.code}`);
+        }
+        return response;
+    };
+    /**
+     * Get the bindings object
+     * 获取绑定对象
+     */
+    getBindings() {
+        return this.bindings;
+    }
+    /**
+     * Expose API to the main world using contextBridge
+     * 使用 contextBridge 将 API 暴露给主世界
+     * @param apiKey - The key to expose on window object (default: 'ipcApi')
+     */
+    exposeApi(apiKey = 'ipcApi') {
+        try {
+            electron.contextBridge.exposeInMainWorld(apiKey, this.bindings);
+        }
+        catch (error) {
+            console.error('[IpcRendererBridge] Failed to expose API:', error);
+        }
+    }
+}
+const ipcRendererBridge = new IpcRendererBridge();exports.IpcRendererBridge=IpcRendererBridge;exports.ipcRendererBridge=ipcRendererBridge;//# sourceMappingURL=index.js.map

package/dist/preload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/preload/index.ts"],"sourcesContent":["import { ipcRenderer, contextBridge } from 'electron';\nimport { IpcRendererBindings, PreloadConfig } from './preload.type';\nimport { IPC_CHANNELS } from '@/core/window/constants';\nexport * from './preload.type';\n\n/**\n * IpcRendererBridge - Secure IPC Bridge for Renderer Process\n * IpcRendererBridge - 渲染进程的安全 IPC 桥接器\n */\nexport class IpcRendererBridge {\n  private bindings: IpcRendererBindings;\n  private channel: string = IPC_CHANNELS.RENDERER_TO_MAIN;\n  private syncChannel: string = IPC_CHANNELS.RENDERER_TO_MAIN_SYNC;\n\n  constructor() {\n    this.bindings = {\n      invoke: this.invoke.bind(this),\n      sendSync: this.sendSync.bind(this),\n    };\n  }\n\n  /**\n   * Configure the IPC channels\n   * 配置 IPC 频道\n   * @param config - The configuration object\n   */\n  public configure(config: PreloadConfig): void {\n    if (config.channel) {\n      this.channel = config.channel;\n    }\n    if (config.syncChannel) {\n      this.syncChannel = config.syncChannel;\n    }\n  }\n\n  /**\n   * Send an asynchronous message to the main process\n   * 发送异步消息到主进程\n   * @param name - Handler name (处理器名称)\n   * @param payload - Data payload (数据负载)\n   */\n  private invoke = async <T = unknown>(name: string, payload?: unknown): Promise<T> => {\n    const response = await ipcRenderer.invoke(this.channel, {\n      name,\n      payload,\n    });\n\n    // Automatic unwrapping of standard response format\n    // 自动解包标准响应格式\n    if (response && typeof response === 'object' && 'code' in response) {\n      if (response.code === 0) {\n        return response.data as T;\n      }\n      throw new Error(response.message || `IPC Error: ${response.code}`);\n    }\n\n    return response as T;\n  };\n\n  /**\n   * Send a synchronous message to the main process\n   * 发送同步消息到主进程\n   * @param name - Handler name (处理器名称)\n   * @param payload - Data payload (数据负载)\n   */\n  private sendSync = <T = unknown>(name: string, payload?: unknown): T => {\n    const response = ipcRenderer.sendSync(this.syncChannel, {\n      name,\n      payload,\n    });\n\n    // Automatic unwrapping of standard response format\n    // 自动解包标准响应格式\n    if (response && typeof response === 'object' && 'code' in response) {\n      if (response.code === 0) {\n        return response.data as T;\n      }\n      throw new Error(response.message || `IPC Error: ${response.code}`);\n    }\n\n    return response as T;\n  };\n\n  /**\n   * Get the bindings object\n   * 获取绑定对象\n   */\n  public getBindings(): IpcRendererBindings {\n    return this.bindings;\n  }\n\n  /**\n   * Expose API to the main world using contextBridge\n   * 使用 contextBridge 将 API 暴露给主世界\n   * @param apiKey - The key to expose on window object (default: 'ipcApi')\n   */\n  public exposeApi(apiKey: string = 'ipcApi'): void {\n    try {\n      contextBridge.exposeInMainWorld(apiKey, this.bindings);\n    } catch (error) {\n      console.error('[IpcRendererBridge] Failed to expose API:', error);\n    }\n  }\n}\n\nconst ipcRendererBridge = new IpcRendererBridge();\nexport { ipcRendererBridge };\n"],"names":["IPC_CHANNELS","ipcRenderer","contextBridge"],"mappings":"+FAKA;;;AAGG;MACU,iBAAiB,CAAA;AACpB,IAAA,QAAQ;AACR,IAAA,OAAO,GAAWA,sBAAY,CAAC,gBAAgB;AAC/C,IAAA,WAAW,GAAWA,sBAAY,CAAC,qBAAqB;AAEhE,IAAA,WAAA,GAAA;QACE,IAAI,CAAC,QAAQ,GAAG;YACd,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC;IACH;AAEA;;;;AAIG;AACI,IAAA,SAAS,CAAC,MAAqB,EAAA;AACpC,QAAA,IAAI,MAAM,CAAC,OAAO,EAAE;AAClB,YAAA,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO;QAC/B;AACA,QAAA,IAAI,MAAM,CAAC,WAAW,EAAE;AACtB,YAAA,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW;QACvC;IACF;AAEA;;;;;AAKG;AACK,IAAA,MAAM,GAAG,OAAoB,IAAY,EAAE,OAAiB,KAAgB;QAClF,MAAM,QAAQ,GAAG,MAAMC,oBAAW,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACtD,IAAI;YACJ,OAAO;AACR,SAAA,CAAC;;;QAIF,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,IAAI,QAAQ,EAAE;AAClE,YAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE;gBACvB,OAAO,QAAQ,CAAC,IAAS;YAC3B;AACA,YAAA,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAA,WAAA,EAAc,QAAQ,CAAC,IAAI,CAAA,CAAE,CAAC;QACpE;AAEA,QAAA,OAAO,QAAa;AACtB,IAAA,CAAC;AAED;;;;;AAKG;AACK,IAAA,QAAQ,GAAG,CAAc,IAAY,EAAE,OAAiB,KAAO;QACrE,MAAM,QAAQ,GAAGA,oBAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE;YACtD,IAAI;YACJ,OAAO;AACR,SAAA,CAAC;;;QAIF,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,IAAI,QAAQ,EAAE;AAClE,YAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE;gBACvB,OAAO,QAAQ,CAAC,IAAS;YAC3B;AACA,YAAA,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAA,WAAA,EAAc,QAAQ,CAAC,IAAI,CAAA,CAAE,CAAC;QACpE;AAEA,QAAA,OAAO,QAAa;AACtB,IAAA,CAAC;AAED;;;AAGG;IACI,WAAW,GAAA;QAChB,OAAO,IAAI,CAAC,QAAQ;IACtB;AAEA;;;;AAIG;IACI,SAAS,CAAC,SAAiB,QAAQ,EAAA;AACxC,QAAA,IAAI;YACFC,sBAAa,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxD;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC;QACnE;IACF;AACD;AAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB"}

package/dist/preload/index.mjs

@@ -0,0 +1,91 @@
+import {ipcRenderer,contextBridge}from'electron';import {IPC_CHANNELS}from'../core/window/constants.mjs';/**
+ * IpcRendererBridge - Secure IPC Bridge for Renderer Process
+ * IpcRendererBridge - 渲染进程的安全 IPC 桥接器
+ */
+class IpcRendererBridge {
+    bindings;
+    channel = IPC_CHANNELS.RENDERER_TO_MAIN;
+    syncChannel = IPC_CHANNELS.RENDERER_TO_MAIN_SYNC;
+    constructor() {
+        this.bindings = {
+            invoke: this.invoke.bind(this),
+            sendSync: this.sendSync.bind(this),
+        };
+    }
+    /**
+     * Configure the IPC channels
+     * 配置 IPC 频道
+     * @param config - The configuration object
+     */
+    configure(config) {
+        if (config.channel) {
+            this.channel = config.channel;
+        }
+        if (config.syncChannel) {
+            this.syncChannel = config.syncChannel;
+        }
+    }
+    /**
+     * Send an asynchronous message to the main process
+     * 发送异步消息到主进程
+     * @param name - Handler name (处理器名称)
+     * @param payload - Data payload (数据负载)
+     */
+    invoke = async (name, payload) => {
+        const response = await ipcRenderer.invoke(this.channel, {
+            name,
+            payload,
+        });
+        // Automatic unwrapping of standard response format
+        // 自动解包标准响应格式
+        if (response && typeof response === 'object' && 'code' in response) {
+            if (response.code === 0) {
+                return response.data;
+            }
+            throw new Error(response.message || `IPC Error: ${response.code}`);
+        }
+        return response;
+    };
+    /**
+     * Send a synchronous message to the main process
+     * 发送同步消息到主进程
+     * @param name - Handler name (处理器名称)
+     * @param payload - Data payload (数据负载)
+     */
+    sendSync = (name, payload) => {
+        const response = ipcRenderer.sendSync(this.syncChannel, {
+            name,
+            payload,
+        });
+        // Automatic unwrapping of standard response format
+        // 自动解包标准响应格式
+        if (response && typeof response === 'object' && 'code' in response) {
+            if (response.code === 0) {
+                return response.data;
+            }
+            throw new Error(response.message || `IPC Error: ${response.code}`);
+        }
+        return response;
+    };
+    /**
+     * Get the bindings object
+     * 获取绑定对象
+     */
+    getBindings() {
+        return this.bindings;
+    }
+    /**
+     * Expose API to the main world using contextBridge
+     * 使用 contextBridge 将 API 暴露给主世界
+     * @param apiKey - The key to expose on window object (default: 'ipcApi')
+     */
+    exposeApi(apiKey = 'ipcApi') {
+        try {
+            contextBridge.exposeInMainWorld(apiKey, this.bindings);
+        }
+        catch (error) {
+            console.error('[IpcRendererBridge] Failed to expose API:', error);
+        }
+    }
+}
+const ipcRendererBridge = new IpcRendererBridge();export{IpcRendererBridge,ipcRendererBridge};//# sourceMappingURL=index.mjs.map