electron-infra-kit 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 chunhaofen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,302 @@
+# Electron Infra Kit
+
+[![npm version](https://img.shields.io/npm/v/electron-infra-kit.svg)](https://www.npmjs.com/package/electron-infra-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A comprehensive infrastructure kit for Electron applications, featuring a robust window manager with state persistence, inter-window communication, and full TypeScript support.
+
+## ✨ Features
+
+- 🪟 **Window Manager** - Lifecycle management, state persistence, plugin system
+- 🔌 **IPC Router** - Type-safe communication with dependency injection
+- 🌉 **Message Bus** - Real-time state sync across windows via MessageChannel
+- ⚙️ **Config Manager** - Persistent configuration with Zod validation
+- 🐛 **Debug Tools** - Performance monitoring and development utilities
+- 📋 **Type Safety** - Full TypeScript support with runtime validation
+
+## 📦 Installation
+
+```bash
+npm install electron-infra-kit
+# or
+pnpm add electron-infra-kit
+```
+
+**Requirements**: Electron >= 22.0.0, TypeScript >= 5.0.0, Node.js >= 18.0.0
+
+## 🚀 Quick Start
+
+```typescript
+import { app } from 'electron';
+import { createElectronToolkit } from 'electron-infra-kit';
+
+app.whenReady().then(async () => {
+  // Initialize kit
+  const { windowManager, ipcRouter, messageBus } = createElectronToolkit({
+    isDevelopment: process.env.NODE_ENV === 'development',
+  });
+
+  // Wait for initialization
+  await windowManager.ready();
+
+  // Create window
+  await windowManager.create({
+    name: 'main',
+    title: 'My App',
+    width: 1024,
+    height: 768,
+  });
+});
+```
+
+**That's it!** You now have:
+
+- ✅ Window management with state persistence
+- ✅ Type-safe IPC communication
+- ✅ Cross-window state synchronization
+- ✅ Performance monitoring (in dev mode)
+
+## 📖 Documentation
+
+### Getting Started
+
+- **[Quick Start Guide](./QUICKSTART.md)** - Get up and running in 5 minutes
+- **[Complete Example](./guides/COOKBOOK.md)** - Full working example with all features
+
+### Core Concepts
+
+- **[Window Manager](./guides/core/window/README.md)** - Window lifecycle and management
+- **[IPC Router](./guides/core/ipc/README.md)** - Type-safe inter-process communication
+- **[Message Bus](./guides/core/message-bus/README.md)** - State synchronization
+- **[Lifecycle Manager](./guides/core/lifecycle/README.md)** - Application lifecycle
+
+### Advanced Topics
+
+- **[Type Safety Guide](./guides/type-safety/TYPE_SAFETY.md)** - TypeScript best practices
+- **[Performance Optimization](./guides/performance/PERFORMANCE.md)** - Tips and tricks
+- **[Error Handling](./guides/infrastructure/errors/ERROR_HANDLING.md)** - Robust error management
+- **[Debugging](./guides/infrastructure/debug/README.md)** - Development tools
+
+### API Reference
+
+- **[Full API Documentation](./guides/README.md)** - Complete API reference
+- **[Type Definitions](./src/types.ts)** - TypeScript types
+
+## 💡 Key Concepts
+
+### Window Manager
+
+<details>
+<summary><b>Architecture Diagram</b></summary>
+
+```
+                                  ┌───────────────────┐
+                                  │   WindowStore     │
+                                  │   (Core Facade)   │
+                                  └─────────┬─────────┘
+                                            │
+           ┌────────────────┬───────────────┼─────────────────┐
+           ▼                ▼               ▼                 ▼
+    ┌────────────┐   ┌────────────┐  ┌──────────────┐  ┌──────────────┐
+    │  Registry  │   │  Operator  │  │ StateManager │  │ ContextMgr   │
+    │ (Storage)  │   │ (Actions)  │  │ (Persistence)│  │ (Ctx Data)   │
+    └────────────┘   └────────────┘  └──────────────┘  └──────────────┘
+
+                                            ▲
+                                            │ composes
+                                            │
+                                  ┌─────────┴─────────┐
+                                  │   WindowManager   │
+                                  │ (High-Level API)  │
+                                  └─────────┬─────────┘
+                                            │
+                                            ▼
+                                     ┌──────────────┐
+                                     │   Plugins    │
+                                     │ & Lifecycle  │
+                                     └──────────────┘
+```
+
+</details>
+
+```typescript
+// Create and manage windows
+const windowId = await windowManager.create({
+  name: 'editor',
+  width: 800,
+  height: 600,
+});
+
+// Close window (new unified API)
+windowManager.close(windowId);
+```
+
+### IPC Router
+
+<details>
+<summary><b>Architecture Diagram</b></summary>
+
+```
+Renderer Process                      Main Process
+┌──────────────────────┐          ┌─────────────────────────────────────┐
+│                      │          │                                     │
+│  ipcRenderer.invoke  │─────────►│  ipcMain.handle('channel')          │
+│   (name, data)       │          │            │                        │
+│                      │          │            ▼                        │
+│                      │          │      ┌─────────────┐                │
+│                      │          │      │  IpcRouter  │                │
+│                      │          │      └─────────────┘                │
+│                      │          │            │                        │
+│                      │          │    1. Validate Request (Zod)        │
+│                      │          │    2. Find Handler by 'name'        │
+│                      │          │    3. Inject API (DI Container)     │
+│                      │          │            │                        │
+│                      │          │            ▼                        │
+│                      │          │      ┌─────────────┐                │
+│                      │          │      │ IpcHandler  │                │
+│                      │          │      │ (Business)  │◄── APIs        │
+│                      │          │      └─────────────┘                │
+│                      │          │            │                        │
+│                      │          │            ▼                        │
+│                      │          │      Return Result                  │
+│                      │          │    (Promise<Result>)                │
+│                      │          │                                     │
+└──────────────────────┘          └─────────────────────────────────────┘
+```
+
+</details>
+
+```typescript
+// Define type-safe handlers
+const handler = new IpcHandler(
+  'getUser',
+  'user',
+  async (context, payload: { id: string }) => {
+    return { id: payload.id, name: 'User' };
+  },
+  z.object({ id: z.string() })
+);
+
+ipcRouter.addHandler(handler);
+```
+
+### Message Bus
+
+<details>
+<summary><b>Architecture Diagram</b></summary>
+
+```
+      Main Process                          Renderer Process
+┌─────────────────────────────┐          ┌──────────────────────┐
+│         MessageBus          │          │       Window A       │
+│      (Shared Instance)      │          │ (MessagePort Client) │
+│                             │◄──IPC────┤                      │
+│  ┌───────────────────────┐  │          │      Local Cache     │
+│  │ DataStore (Map)       │  │          └──────────▲───────────┘
+│  │ - key: value          │  │                     │
+│  │ - permission          │  │                     │
+│  └──────────▲────────────┘  │                     │
+│             │               │          ┌──────────▼───────────┐
+│  ┌──────────▼────────────┐  │          │       Window B       │
+│  │ MessageDispatcher     │──┼─Broadcast│ (MessagePort Client) │
+│  └──────────┬────────────┘  │─────────►│                      │
+│             │               │          │      Local Cache     │
+│  ┌──────────▼────────────┐  │          └──────────────────────┘
+│  │ WindowPorts (Map)     │  │
+│  │ - winId: MessagePort  │  │
+│  └───────────────────────┘  │
+└─────────────────────────────┘
+```
+
+</details>
+
+```typescript
+// Sync state across windows
+messageBus.setData('theme', 'dark');
+
+// Watch for changes (remember to unsubscribe!)
+const unsubscribe = messageBus.watch('theme', (newValue) => {
+  console.log('Theme changed:', newValue);
+});
+```
+
+## 🎯 Use Cases
+
+- **Multi-window IDEs** - Code editors with multiple panels
+- **Design Tools** - Apps with canvas, properties, and toolbars
+- **Collaboration Apps** - Real-time state sync across windows
+- **Enterprise Apps** - Large-scale applications with complex workflows
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────┐
+│         LifecycleManager                │
+│    (Orchestrates everything)            │
+└─────────────────────────────────────────┘
+                  │
+    ┌─────────────┼─────────────┐
+    ▼             ▼             ▼
+┌─────────┐  ┌─────────┐  ┌─────────┐
+│ Window  │◄─┤   IPC   │◄─┤ Message │
+│ Manager │  │ Router  │  │   Bus   │
+└─────────┘  └─────────┘  └─────────┘
+```
+
+**Design Principles**:
+
+- 🎯 Separation of Concerns - Each module has a single responsibility
+- 🔒 Type Safety First - Full TypeScript support with runtime validation
+- ⚡ Performance Optimized - MessageChannel-based communication
+- 🔌 Extensible - Plugin system for custom functionality
+- 🛡️ Secure by Default - Context isolation and sandboxing
+
+## 📂 Directory Structure
+
+```
+electron-infra-kit/
+├── src/                    # Source code
+│   ├── core/               # Core modules
+│   │   ├── window/         # Window Manager
+│   │   ├── ipc/            # IPC Router
+│   │   ├── message-bus/    # Message Bus
+│   │   └── lifecycle/      # Lifecycle Manager
+│   ├── infrastructure/     # Infrastructure modules
+│   │   ├── config/         # Configuration
+│   │   ├── debug/          # Debugging tools
+│   │   ├── errors/         # Error handling
+│   │   └── logger/         # Logging
+│   └── preload/            # Preload scripts
+├── examples/               # Example projects
+└── guides/                 # Documentation
+```
+
+## 🤝 Contributing
+
+We welcome contributions! See [DEVELOPMENT.md](./DEVELOPMENT.md) for:
+
+- Development setup
+- Coding standards
+- Commit conventions
+- Release process
+
+## 📄 License
+
+[MIT](./LICENSE) © [chunhaofen](https://github.com/chunhaofen)
+
+---
+
+## 🔗 Links
+
+- **[GitHub Repository](https://github.com/chunhaofen/electron-infra-kit)**
+- **[npm Package](https://www.npmjs.com/package/electron-infra-kit)**
+- **[Issue Tracker](https://github.com/chunhaofen/electron-infra-kit/issues)**
+- **[Changelog](./CHANGELOG.md)**
+
+## ⭐ Star History
+
+If you find this project helpful, please consider giving it a star! ⭐
+
+---
+
+**Made with ❤️ for the Electron community**

package/README.zh-CN.md

@@ -0,0 +1,308 @@
+# Electron Infra Kit
+
+[![npm version](https://img.shields.io/npm/v/electron-infra-kit.svg)](https://www.npmjs.com/package/electron-infra-kit)
+[![npm downloads](https://img.shields.io/npm/dm/electron-infra-kit.svg)](https://www.npmjs.com/package/electron-infra-kit)
+[![CI](https://github.com/chunhaofen/electron-infra-kit.git/actions/workflows/ci.yml/badge.svg)](https://github.com/chunhaofen/electron-infra-kit.git/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/electron-infra-kit.svg)](https://github.com/chunhaofen/electron-infra-kit.git/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
+
+[English](./README.md) | 简体中文
+
+为 Electron 应用打造的综合基础设施工具包，提供窗口管理、IPC 路由和状态同步功能。
+
+## ✨ 特性
+
+- 🪟 **窗口管理器** - 生命周期管理、状态持久化、插件系统
+- 🔌 **IPC 路由** - 类型安全的通信，支持依赖注入
+- 🌉 **消息总线** - 基于 MessageChannel 的跨窗口实时状态同步
+- ⚙️ **配置管理器** - 持久化配置，支持 Zod 验证
+- 🐛 **调试工具** - 性能监控和开发工具
+- 📋 **类型安全** - 完整的 TypeScript 支持和运行时验证
+
+## 📦 安装
+
+```bash
+npm install electron-infra-kit
+# 或
+pnpm add electron-infra-kit
+```
+
+**依赖要求**: Electron >= 22.0.0, TypeScript >= 5.0.0, Node.js >= 18.0.0
+
+## 🚀 快速开始
+
+```typescript
+import { app } from 'electron';
+import { createElectronToolkit } from 'electron-infra-kit';
+
+app.whenReady().then(async () => {
+  // 初始化工具包
+  const { windowManager, ipcRouter, messageBus } = createElectronToolkit({
+    isDevelopment: process.env.NODE_ENV === 'development',
+  });
+
+  // 等待初始化完成
+  await windowManager.ready();
+
+  // 创建窗口
+  await windowManager.create({
+    name: 'main',
+    title: '我的应用',
+    width: 1024,
+    height: 768,
+  });
+});
+```
+
+**就这么简单！** 你现在拥有：
+
+- ✅ 带状态持久化的窗口管理
+- ✅ 类型安全的 IPC 通信
+- ✅ 跨窗口状态同步
+- ✅ 性能监控（开发模式）
+
+## 📖 文档
+
+### 入门指南
+
+- **[快速开始](./QUICKSTART.zh-CN.md)** - 5分钟快速上手
+- **[完整示例](./guides/COOKBOOK.zh-CN.md)** - 包含所有功能的完整示例
+- **[迁移指南](./IMPROVEMENTS.md)** - 从旧版本升级
+
+### 核心概念
+
+- **[窗口管理器](./guides/core/window/README.zh-CN.md)** - 窗口生命周期和管理
+- **[IPC 路由](./guides/core/ipc/README.zh-CN.md)** - 类型安全的进程间通信
+- **[消息总线](./guides/core/message-bus/README.zh-CN.md)** - 状态同步
+- **[生命周期管理器](./guides/core/lifecycle/README.zh-CN.md)** - 应用生命周期
+
+### 进阶主题
+
+- **[类型安全指南](./guides/type-safety/TYPE_SAFETY.zh-CN.md)** - TypeScript 最佳实践
+- **[性能优化](./guides/performance/PERFORMANCE.zh-CN.md)** - 技巧和窍门
+- **[错误处理](./guides/infrastructure/errors/ERROR_HANDLING.zh-CN.md)** - 健壮的错误管理
+- **[调试](./guides/infrastructure/debug/README.zh-CN.md)** - 开发工具
+
+### API 参考
+
+- **[完整 API 文档](./guides/README.zh-CN.md)** - 完整的 API 参考
+- **[类型定义](./src/types.ts)** - TypeScript 类型
+
+## 💡 核心概念
+
+### 窗口管理器
+
+<details>
+<summary><b>架构图</b></summary>
+
+```
+                                  ┌───────────────────┐
+                                  │   WindowStore     │
+                                  │   (核心门面)       │
+                                  └─────────┬─────────┘
+                                            │
+           ┌────────────────┬───────────────┼─────────────────┐
+           ▼                ▼               ▼                 ▼
+    ┌────────────┐   ┌────────────┐  ┌──────────────┐  ┌──────────────┐
+    │  Registry  │   │  Operator  │  │ StateManager │  │ ContextMgr   │
+    │  (存储)     │   │  (操作)     │  │  (持久化)     │  │ (上下文数据)  │
+    └────────────┘   └────────────┘  └──────────────┘  └──────────────┘
+
+                                            ▲
+                                            │ 组合
+                                            │
+                                  ┌─────────┴─────────┐
+                                  │   WindowManager   │
+                                  │   (高级 API)       │
+                                  └─────────┬─────────┘
+                                            │
+                                            ▼
+                                     ┌──────────────┐
+                                     │   Plugins    │
+                                     │ & Lifecycle  │
+                                     └──────────────┘
+```
+
+</details>
+
+```typescript
+// 创建和管理窗口
+const windowId = await windowManager.create({
+  name: 'editor',
+  width: 800,
+  height: 600,
+});
+
+// 关闭窗口（新的统一 API）
+windowManager.close(windowId);
+```
+
+### IPC 路由
+
+<details>
+<summary><b>架构图</b></summary>
+
+```
+渲染进程 (Renderer)                   主进程 (Main)
+┌──────────────────────┐          ┌─────────────────────────────────────┐
+│                      │          │                                     │
+│  ipcRenderer.invoke  │─────────►│  ipcMain.handle('channel')          │
+│   (name, data)       │          │            │                        │
+│                      │          │            ▼                        │
+│                      │          │      ┌─────────────┐                │
+│                      │          │      │  IpcRouter  │                │
+│                      │          │      └─────────────┘                │
+│                      │          │            │                        │
+│                      │          │    1. 验证请求 (Zod)                 │
+│                      │          │    2. 查找处理器 ('name')            │
+│                      │          │    3. 注入 API (DI 容器)             │
+│                      │          │            │                        │
+│                      │          │            ▼                        │
+│                      │          │      ┌─────────────┐                │
+│                      │          │      │ IpcHandler  │                │
+│                      │          │      │  (业务逻辑)  │◄── APIs        │
+│                      │          │      └─────────────┘                │
+│                      │          │            │                        │
+│                      │          │            ▼                        │
+│                      │          │       返回结果                       │
+│                      │          │    (Promise<Result>)                │
+│                      │          │                                     │
+└──────────────────────┘          └─────────────────────────────────────┘
+```
+
+</details>
+
+```typescript
+// 定义类型安全的处理器
+const handler = new IpcHandler(
+  'getUser',
+  'user',
+  async (context, payload: { id: string }) => {
+    return { id: payload.id, name: '用户' };
+  },
+  z.object({ id: z.string() })
+);
+
+ipcRouter.addHandler(handler);
+```
+
+### 消息总线
+
+<details>
+<summary><b>架构图</b></summary>
+
+```
+       主进程 (Main)                         渲染进程 (Renderer)
+┌─────────────────────────────┐          ┌──────────────────────┐
+│         MessageBus          │          │       窗口 A         │
+│        (共享实例)            │          │ (MessagePort Client) │
+│                             │◄──IPC────┤                      │
+│  ┌───────────────────────┐  │          │      本地缓存         │
+│  │ DataStore (Map)       │  │          └──────────▲───────────┘
+│  │ - key: value          │  │                     │
+│  │ - permission          │  │                     │
+│  └──────────▲────────────┘  │                     │
+│             │               │          ┌──────────▼───────────┐
+│  ┌──────────▼────────────┐  │          │       窗口 B         │
+│  │ MessageDispatcher     │──┼─广播─────│ (MessagePort Client) │
+│  └──────────┬────────────┘  │─────────►│                      │
+│             │               │          │      本地缓存         │
+│  ┌──────────▼────────────┐  │          └──────────────────────┘
+│  │ WindowPorts (Map)     │  │
+│  │ - winId: MessagePort  │  │
+│  └───────────────────────┘  │
+└─────────────────────────────┘
+```
+
+</details>
+
+```typescript
+// 跨窗口同步状态
+messageBus.setData('theme', 'dark');
+
+// 监听变化（记得取消订阅！）
+const unsubscribe = messageBus.watch('theme', (newValue) => {
+  console.log('主题变更:', newValue);
+});
+```
+
+## 🎯 适用场景
+
+- **多窗口 IDE** - 带有多个面板的代码编辑器
+- **设计工具** - 包含画布、属性和工具栏的应用
+- **协作应用** - 跨窗口实时状态同步
+- **企业应用** - 具有复杂工作流的大型应用
+
+## 🏗️ 架构
+
+```
+┌─────────────────────────────────────────┐
+│         LifecycleManager                │
+│         (编排所有模块)                   │
+└─────────────────────────────────────────┘
+                  │
+    ┌─────────────┼─────────────┐
+    ▼             ▼             ▼
+┌─────────┐  ┌─────────┐  ┌─────────┐
+│ Window  │◄─┤   IPC   │◄─┤ Message │
+│ Manager │  │ Router  │  │   Bus   │
+└─────────┘  └─────────┘  └─────────┘
+```
+
+**设计原则**:
+
+- 🎯 关注点分离 - 每个模块都有单一职责
+- 🔒 类型安全优先 - 完整的 TypeScript 支持和运行时验证
+- ⚡ 性能优化 - 基于 MessageChannel 的通信
+- 🔌 可扩展 - 插件系统支持自定义功能
+- 🛡️ 默认安全 - 上下文隔离和沙箱机制
+
+## 📂 目录结构
+
+```
+electron-infra-kit/
+├── src/                    # 源代码
+│   ├── core/               # 核心模块
+│   │   ├── window/         # 窗口管理器
+│   │   ├── ipc/            # IPC 路由
+│   │   ├── message-bus/    # 消息总线
+│   │   └── lifecycle/      # 生命周期管理器
+│   ├── infrastructure/     # 基础设施模块
+│   │   ├── config/         # 配置管理
+│   │   ├── debug/          # 调试工具
+│   │   ├── errors/         # 错误处理
+│   │   └── logger/         # 日志记录
+│   └── preload/            # 预加载脚本
+├── examples/               # 示例项目
+└── guides/                 # 文档指南
+```
+
+## 🤝 贡献
+
+欢迎提交贡献！请查看 [DEVELOPMENT.md](./DEVELOPMENT.md) 了解：
+
+- 开发环境设置
+- 代码规范
+- 提交规范
+- 发布流程
+
+## 📄 许可证
+
+[MIT](./LICENSE) © [chunhaofen](https://github.com/chunhaofen)
+
+---
+
+## 🔗 链接
+
+- **[GitHub 仓库](https://github.com/chunhaofen/electron-infra-kit)**
+- **[npm 包](https://www.npmjs.com/package/electron-infra-kit)**
+- **[问题追踪](https://github.com/chunhaofen/electron-infra-kit/issues)**
+- **[更新日志](./CHANGELOG.md)**
+
+## ⭐ Star 历史
+
+如果这个项目对你有帮助，请考虑给它一个 star！⭐
+
+---
+
+**用 ❤️ 为 Electron 社区打造**

package/dist/core/error/WindowError.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Window Error Codes
+ * 窗口错误代码
+ */
+export declare enum WindowErrorCode {
+    CONFIG_INVALID = 1001,
+    CONFIG_MISSING = 1002,
+    WINDOW_NOT_FOUND = 2001,
+    WINDOW_CREATION_FAILED = 2002,
+    WINDOW_ALREADY_EXISTS = 2003,
+    WINDOW_LIMIT_REACHED = 2004,
+    WINDOW_DESTROYED = 2005,
+    IPC_CONNECTION_FAILED = 3001,
+    IPC_TIMEOUT = 3002,
+    IPC_HANDLER_ERROR = 3003,
+    INTERNAL_ERROR = 5001,
+    DEPENDENCY_MISSING = 5002
+}
+/**
+ * Window Error Options
+ * 窗口错误选项
+ */
+export interface WindowErrorOptions {
+    code: WindowErrorCode;
+    message: string;
+    originalError?: Error | unknown;
+    details?: Record<string, any>;
+    suggestion?: string;
+}
+/**
+ * Window Error Class
+ * 窗口错误类
+ *
+ * Structured error handling for the WindowManager
+ * 为 WindowManager 提供结构化的错误处理
+ */
+export declare class WindowError extends Error {
+    readonly code: WindowErrorCode;
+    readonly originalError?: Error | unknown;
+    readonly details?: Record<string, any>;
+    readonly suggestion?: string;
+    constructor(options: WindowErrorOptions);
+    /**
+     * Get error category based on code
+     * 根据错误代码获取错误类别
+     */
+    getErrorCategory(): 'configuration' | 'window' | 'ipc' | 'system' | 'unknown';
+    toJSON(): {
+        name: string;
+        message: string;
+        code: WindowErrorCode;
+        category: "ipc" | "window" | "unknown" | "configuration" | "system";
+        details: Record<string, any> | undefined;
+        suggestion: string | undefined;
+    };
+}