electron-infra-kit 0.0.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/core/window/index.mjs

@@ -0,0 +1 @@
+export{default as WindowStore}from'./WindowStore.mjs';export{default as WindowManager}from'./WindowManager.mjs';export{default as WindowCreator}from'./WindowCreator.mjs';export{IpcSetup}from'./IpcSetup.mjs';export{WindowError,WindowErrorCode}from'../error/WindowError.mjs';export{validateWindowManagerConfig}from'./window-manager.schema.mjs';//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/core/window/window-manager.schema.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { ILogger } from '@/infrastructure/logger';
+import IpcRouter from '@/core/ipc/IpcRouter';
+import { MessageBus } from '@/core/message-bus/MessageBus';
+/**
+ * Logger interface schema for runtime validation
+ * Logger 接口的运行时验证 schema
+ */
+export declare const LoggerSchema: z.ZodCustom<ILogger, ILogger>;
+/**
+ * IpcRouter interface schema for runtime validation
+ * IpcRouter 接口的运行时验证 schema
+ */
+export declare const IpcRouterSchema: z.ZodCustom<IpcRouter<Record<string, any>, Record<string, import("../ipc").IpcDefinition<any, any>>>, IpcRouter<Record<string, any>, Record<string, import("../ipc").IpcDefinition<any, any>>>>;
+/**
+ * MessageBus interface schema for runtime validation
+ * MessageBus 接口的运行时验证 schema
+ */
+export declare const MessageBusSchema: z.ZodCustom<MessageBus, MessageBus>;
+/**
+ * WindowManagerConfig schema
+ * WindowManager 配置验证 schema
+ */
+export declare const WindowManagerConfigSchema: z.ZodObject<{
+    logger: z.ZodOptional<z.ZodCustom<ILogger, ILogger>>;
+    ipcRouter: z.ZodOptional<z.ZodCustom<IpcRouter<Record<string, any>, Record<string, import("../ipc").IpcDefinition<any, any>>>, IpcRouter<Record<string, any>, Record<string, import("../ipc").IpcDefinition<any, any>>>>>;
+    messageBus: z.ZodOptional<z.ZodCustom<MessageBus, MessageBus>>;
+    isDevelopment: z.ZodDefault<z.ZodBoolean>;
+    preventExternalLinks: z.ZodDefault<z.ZodBoolean>;
+    defaultConfig: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    plugins: z.ZodDefault<z.ZodArray<z.ZodAny>>;
+    hooks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    ipc: z.ZodDefault<z.ZodObject<{
+        autoInit: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    store: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    ipcSetup: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    ipcTransport: z.ZodOptional<z.ZodAny>;
+}, z.core.$strict>;
+/**
+ * Validate WindowManagerConfig
+ * 验证 WindowManagerConfig
+ * @param config - Configuration to validate
+ * @returns Validation result
+ */
+export declare function validateWindowManagerConfig(config: any): {
+    success: boolean;
+    error?: string;
+    data?: z.infer<typeof WindowManagerConfigSchema>;
+};

package/dist/core/window/window-manager.schema.js

@@ -0,0 +1,87 @@
+'use strict';var zod=require('zod');/**
+ * Logger interface schema for runtime validation
+ * Logger 接口的运行时验证 schema
+ */
+const LoggerSchema = zod.z.custom((val) => {
+    return (typeof val === 'object' &&
+        val !== null &&
+        'info' in val &&
+        'warn' in val &&
+        'error' in val &&
+        'debug' in val &&
+        typeof val.info === 'function' &&
+        typeof val.warn === 'function' &&
+        typeof val.error === 'function' &&
+        typeof val.debug === 'function');
+}, 'Logger must implement ILogger interface with info/warn/error/debug methods');
+/**
+ * IpcRouter interface schema for runtime validation
+ * IpcRouter 接口的运行时验证 schema
+ */
+const IpcRouterSchema = zod.z.custom((val) => {
+    return (typeof val === 'object' &&
+        val !== null &&
+        'handle' in val &&
+        'addHandler' in val &&
+        typeof val.handle === 'function' &&
+        typeof val.addHandler === 'function');
+}, 'IpcRouter must implement handle/addHandler methods');
+/**
+ * MessageBus interface schema for runtime validation
+ * MessageBus 接口的运行时验证 schema
+ */
+const MessageBusSchema = zod.z.custom((val) => {
+    return (typeof val === 'object' &&
+        val !== null &&
+        'registerWindow' in val &&
+        'unregisterWindow' in val &&
+        typeof val.registerWindow === 'function' &&
+        typeof val.unregisterWindow === 'function');
+}, 'MessageBus must implement registerWindow/unregisterWindow methods');
+/**
+ * WindowManagerConfig schema
+ * WindowManager 配置验证 schema
+ */
+const WindowManagerConfigSchema = zod.z
+    .object({
+    logger: LoggerSchema.optional(),
+    ipcRouter: IpcRouterSchema.optional(),
+    messageBus: MessageBusSchema.optional(),
+    isDevelopment: zod.z.boolean().default(false),
+    preventExternalLinks: zod.z.boolean().default(true),
+    defaultConfig: zod.z.record(zod.z.string(), zod.z.any()).default({}),
+    plugins: zod.z.array(zod.z.any()).default([]),
+    hooks: zod.z.record(zod.z.string(), zod.z.any()).default({}),
+    ipc: zod.z
+        .object({
+        autoInit: zod.z.boolean().default(true),
+    })
+        .default({ autoInit: true }),
+    store: zod.z.record(zod.z.string(), zod.z.any()).default({}),
+    ipcSetup: zod.z.function().optional(),
+    ipcTransport: zod.z.any().optional(),
+})
+    .strict(); // Enforce no unknown keys for stricter validation
+/**
+ * Validate WindowManagerConfig
+ * 验证 WindowManagerConfig
+ * @param config - Configuration to validate
+ * @returns Validation result
+ */
+function validateWindowManagerConfig(config) {
+    const result = WindowManagerConfigSchema.safeParse(config);
+    if (!result.success) {
+        // Format Zod errors into a readable string
+        const errorMessage = result.error.issues
+            .map((err) => `${err.path.join('.')}: ${err.message}`)
+            .join('; ');
+        return {
+            success: false,
+            error: errorMessage,
+        };
+    }
+    return {
+        success: true,
+        data: result.data,
+    };
+}exports.IpcRouterSchema=IpcRouterSchema;exports.LoggerSchema=LoggerSchema;exports.MessageBusSchema=MessageBusSchema;exports.WindowManagerConfigSchema=WindowManagerConfigSchema;exports.validateWindowManagerConfig=validateWindowManagerConfig;//# sourceMappingURL=window-manager.schema.js.map

package/dist/core/window/window-manager.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-manager.schema.js","sources":["../../../src/core/window/window-manager.schema.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ILogger } from '@/infrastructure/logger';\nimport IpcRouter from '@/core/ipc/IpcRouter';\nimport { MessageBus } from '@/core/message-bus/MessageBus';\n\n/**\n * Logger interface schema for runtime validation\n * Logger 接口的运行时验证 schema\n */\nexport const LoggerSchema = z.custom<ILogger>((val) => {\n  return (\n    typeof val === 'object' &&\n    val !== null &&\n    'info' in val &&\n    'warn' in val &&\n    'error' in val &&\n    'debug' in val &&\n    typeof (val as any).info === 'function' &&\n    typeof (val as any).warn === 'function' &&\n    typeof (val as any).error === 'function' &&\n    typeof (val as any).debug === 'function'\n  );\n}, 'Logger must implement ILogger interface with info/warn/error/debug methods');\n\n/**\n * IpcRouter interface schema for runtime validation\n * IpcRouter 接口的运行时验证 schema\n */\nexport const IpcRouterSchema = z.custom<IpcRouter>((val) => {\n  return (\n    typeof val === 'object' &&\n    val !== null &&\n    'handle' in val &&\n    'addHandler' in val &&\n    typeof (val as any).handle === 'function' &&\n    typeof (val as any).addHandler === 'function'\n  );\n}, 'IpcRouter must implement handle/addHandler methods');\n\n/**\n * MessageBus interface schema for runtime validation\n * MessageBus 接口的运行时验证 schema\n */\nexport const MessageBusSchema = z.custom<MessageBus>((val) => {\n  return (\n    typeof val === 'object' &&\n    val !== null &&\n    'registerWindow' in val &&\n    'unregisterWindow' in val &&\n    typeof (val as any).registerWindow === 'function' &&\n    typeof (val as any).unregisterWindow === 'function'\n  );\n}, 'MessageBus must implement registerWindow/unregisterWindow methods');\n\n/**\n * WindowManagerConfig schema\n * WindowManager 配置验证 schema\n */\nexport const WindowManagerConfigSchema = z\n  .object({\n    logger: LoggerSchema.optional(),\n    ipcRouter: IpcRouterSchema.optional(),\n    messageBus: MessageBusSchema.optional(),\n\n    isDevelopment: z.boolean().default(false),\n    preventExternalLinks: z.boolean().default(true),\n\n    defaultConfig: z.record(z.string(), z.any()).default({}),\n\n    plugins: z.array(z.any()).default([]),\n    hooks: z.record(z.string(), z.any()).default({}),\n\n    ipc: z\n      .object({\n        autoInit: z.boolean().default(true),\n      })\n      .default({ autoInit: true }),\n\n    store: z.record(z.string(), z.any()).default({}),\n\n    ipcSetup: z.function().optional(),\n    ipcTransport: z.any().optional(),\n  })\n  .strict(); // Enforce no unknown keys for stricter validation\n\n/**\n * Validate WindowManagerConfig\n * 验证 WindowManagerConfig\n * @param config - Configuration to validate\n * @returns Validation result\n */\nexport function validateWindowManagerConfig(config: any): {\n  success: boolean;\n  error?: string;\n  data?: z.infer<typeof WindowManagerConfigSchema>;\n} {\n  const result = WindowManagerConfigSchema.safeParse(config);\n  if (!result.success) {\n    // Format Zod errors into a readable string\n    const errorMessage = result.error.issues\n      .map((err) => `${err.path.join('.')}: ${err.message}`)\n      .join('; ');\n\n    return {\n      success: false,\n      error: errorMessage,\n    };\n  }\n  return {\n    success: true,\n    data: result.data,\n  };\n}\n"],"names":["z"],"mappings":"oCAKA;;;AAGG;AACI,MAAM,YAAY,GAAGA,KAAC,CAAC,MAAM,CAAU,CAAC,GAAG,KAAI;AACpD,IAAA,QACE,OAAO,GAAG,KAAK,QAAQ;AACvB,QAAA,GAAG,KAAK,IAAI;AACZ,QAAA,MAAM,IAAI,GAAG;AACb,QAAA,MAAM,IAAI,GAAG;AACb,QAAA,OAAO,IAAI,GAAG;AACd,QAAA,OAAO,IAAI,GAAG;AACd,QAAA,OAAQ,GAAW,CAAC,IAAI,KAAK,UAAU;AACvC,QAAA,OAAQ,GAAW,CAAC,IAAI,KAAK,UAAU;AACvC,QAAA,OAAQ,GAAW,CAAC,KAAK,KAAK,UAAU;AACxC,QAAA,OAAQ,GAAW,CAAC,KAAK,KAAK,UAAU;AAE5C,CAAC,EAAE,4EAA4E;AAE/E;;;AAGG;AACI,MAAM,eAAe,GAAGA,KAAC,CAAC,MAAM,CAAY,CAAC,GAAG,KAAI;AACzD,IAAA,QACE,OAAO,GAAG,KAAK,QAAQ;AACvB,QAAA,GAAG,KAAK,IAAI;AACZ,QAAA,QAAQ,IAAI,GAAG;AACf,QAAA,YAAY,IAAI,GAAG;AACnB,QAAA,OAAQ,GAAW,CAAC,MAAM,KAAK,UAAU;AACzC,QAAA,OAAQ,GAAW,CAAC,UAAU,KAAK,UAAU;AAEjD,CAAC,EAAE,oDAAoD;AAEvD;;;AAGG;AACI,MAAM,gBAAgB,GAAGA,KAAC,CAAC,MAAM,CAAa,CAAC,GAAG,KAAI;AAC3D,IAAA,QACE,OAAO,GAAG,KAAK,QAAQ;AACvB,QAAA,GAAG,KAAK,IAAI;AACZ,QAAA,gBAAgB,IAAI,GAAG;AACvB,QAAA,kBAAkB,IAAI,GAAG;AACzB,QAAA,OAAQ,GAAW,CAAC,cAAc,KAAK,UAAU;AACjD,QAAA,OAAQ,GAAW,CAAC,gBAAgB,KAAK,UAAU;AAEvD,CAAC,EAAE,mEAAmE;AAEtE;;;AAGG;AACI,MAAM,yBAAyB,GAAGA;AACtC,KAAA,MAAM,CAAC;AACN,IAAA,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;AAC/B,IAAA,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;AACrC,IAAA,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAEvC,aAAa,EAAEA,KAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACzC,oBAAoB,EAAEA,KAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;AAE/C,IAAA,aAAa,EAAEA,KAAC,CAAC,MAAM,CAACA,KAAC,CAAC,MAAM,EAAE,EAAEA,KAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AAExD,IAAA,OAAO,EAAEA,KAAC,CAAC,KAAK,CAACA,KAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AACrC,IAAA,KAAK,EAAEA,KAAC,CAAC,MAAM,CAACA,KAAC,CAAC,MAAM,EAAE,EAAEA,KAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AAEhD,IAAA,GAAG,EAAEA;AACF,SAAA,MAAM,CAAC;QACN,QAAQ,EAAEA,KAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACpC;AACA,SAAA,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAE9B,IAAA,KAAK,EAAEA,KAAC,CAAC,MAAM,CAACA,KAAC,CAAC,MAAM,EAAE,EAAEA,KAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;AAEhD,IAAA,QAAQ,EAAEA,KAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;AACjC,IAAA,YAAY,EAAEA,KAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACjC;KACA,MAAM,GAAG;AAEZ;;;;;AAKG;AACG,SAAU,2BAA2B,CAAC,MAAW,EAAA;IAKrD,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,MAAM,CAAC;AAC1D,IAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;;AAEnB,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;aAC/B,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA,EAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA,EAAA,EAAK,GAAG,CAAC,OAAO,EAAE;aACpD,IAAI,CAAC,IAAI,CAAC;QAEb,OAAO;AACL,YAAA,OAAO,EAAE,KAAK;AACd,YAAA,KAAK,EAAE,YAAY;SACpB;IACH;IACA,OAAO;AACL,QAAA,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB;AACH"}

package/dist/core/window/window-manager.schema.mjs

@@ -0,0 +1,87 @@
+import {z}from'zod';/**
+ * Logger interface schema for runtime validation
+ * Logger 接口的运行时验证 schema
+ */
+const LoggerSchema = z.custom((val) => {
+    return (typeof val === 'object' &&
+        val !== null &&
+        'info' in val &&
+        'warn' in val &&
+        'error' in val &&
+        'debug' in val &&
+        typeof val.info === 'function' &&
+        typeof val.warn === 'function' &&
+        typeof val.error === 'function' &&
+        typeof val.debug === 'function');
+}, 'Logger must implement ILogger interface with info/warn/error/debug methods');
+/**
+ * IpcRouter interface schema for runtime validation
+ * IpcRouter 接口的运行时验证 schema
+ */
+const IpcRouterSchema = z.custom((val) => {
+    return (typeof val === 'object' &&
+        val !== null &&
+        'handle' in val &&
+        'addHandler' in val &&
+        typeof val.handle === 'function' &&
+        typeof val.addHandler === 'function');
+}, 'IpcRouter must implement handle/addHandler methods');
+/**
+ * MessageBus interface schema for runtime validation
+ * MessageBus 接口的运行时验证 schema
+ */
+const MessageBusSchema = z.custom((val) => {
+    return (typeof val === 'object' &&
+        val !== null &&
+        'registerWindow' in val &&
+        'unregisterWindow' in val &&
+        typeof val.registerWindow === 'function' &&
+        typeof val.unregisterWindow === 'function');
+}, 'MessageBus must implement registerWindow/unregisterWindow methods');
+/**
+ * WindowManagerConfig schema
+ * WindowManager 配置验证 schema
+ */
+const WindowManagerConfigSchema = z
+    .object({
+    logger: LoggerSchema.optional(),
+    ipcRouter: IpcRouterSchema.optional(),
+    messageBus: MessageBusSchema.optional(),
+    isDevelopment: z.boolean().default(false),
+    preventExternalLinks: z.boolean().default(true),
+    defaultConfig: z.record(z.string(), z.any()).default({}),
+    plugins: z.array(z.any()).default([]),
+    hooks: z.record(z.string(), z.any()).default({}),
+    ipc: z
+        .object({
+        autoInit: z.boolean().default(true),
+    })
+        .default({ autoInit: true }),
+    store: z.record(z.string(), z.any()).default({}),
+    ipcSetup: z.function().optional(),
+    ipcTransport: z.any().optional(),
+})
+    .strict(); // Enforce no unknown keys for stricter validation
+/**
+ * Validate WindowManagerConfig
+ * 验证 WindowManagerConfig
+ * @param config - Configuration to validate
+ * @returns Validation result
+ */
+function validateWindowManagerConfig(config) {
+    const result = WindowManagerConfigSchema.safeParse(config);
+    if (!result.success) {
+        // Format Zod errors into a readable string
+        const errorMessage = result.error.issues
+            .map((err) => `${err.path.join('.')}: ${err.message}`)
+            .join('; ');
+        return {
+            success: false,
+            error: errorMessage,
+        };
+    }
+    return {
+        success: true,
+        data: result.data,
+    };
+}export{IpcRouterSchema,LoggerSchema,MessageBusSchema,WindowManagerConfigSchema,validateWindowManagerConfig};//# sourceMappingURL=window-manager.schema.mjs.map

package/dist/core/window/window-manager.schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-manager.schema.mjs","sources":["../../../src/core/window/window-manager.schema.ts"],"sourcesContent":["import { z } from 'zod';\nimport { ILogger } from '@/infrastructure/logger';\nimport IpcRouter from '@/core/ipc/IpcRouter';\nimport { MessageBus } from '@/core/message-bus/MessageBus';\n\n/**\n * Logger interface schema for runtime validation\n * Logger 接口的运行时验证 schema\n */\nexport const LoggerSchema = z.custom<ILogger>((val) => {\n  return (\n    typeof val === 'object' &&\n    val !== null &&\n    'info' in val &&\n    'warn' in val &&\n    'error' in val &&\n    'debug' in val &&\n    typeof (val as any).info === 'function' &&\n    typeof (val as any).warn === 'function' &&\n    typeof (val as any).error === 'function' &&\n    typeof (val as any).debug === 'function'\n  );\n}, 'Logger must implement ILogger interface with info/warn/error/debug methods');\n\n/**\n * IpcRouter interface schema for runtime validation\n * IpcRouter 接口的运行时验证 schema\n */\nexport const IpcRouterSchema = z.custom<IpcRouter>((val) => {\n  return (\n    typeof val === 'object' &&\n    val !== null &&\n    'handle' in val &&\n    'addHandler' in val &&\n    typeof (val as any).handle === 'function' &&\n    typeof (val as any).addHandler === 'function'\n  );\n}, 'IpcRouter must implement handle/addHandler methods');\n\n/**\n * MessageBus interface schema for runtime validation\n * MessageBus 接口的运行时验证 schema\n */\nexport const MessageBusSchema = z.custom<MessageBus>((val) => {\n  return (\n    typeof val === 'object' &&\n    val !== null &&\n    'registerWindow' in val &&\n    'unregisterWindow' in val &&\n    typeof (val as any).registerWindow === 'function' &&\n    typeof (val as any).unregisterWindow === 'function'\n  );\n}, 'MessageBus must implement registerWindow/unregisterWindow methods');\n\n/**\n * WindowManagerConfig schema\n * WindowManager 配置验证 schema\n */\nexport const WindowManagerConfigSchema = z\n  .object({\n    logger: LoggerSchema.optional(),\n    ipcRouter: IpcRouterSchema.optional(),\n    messageBus: MessageBusSchema.optional(),\n\n    isDevelopment: z.boolean().default(false),\n    preventExternalLinks: z.boolean().default(true),\n\n    defaultConfig: z.record(z.string(), z.any()).default({}),\n\n    plugins: z.array(z.any()).default([]),\n    hooks: z.record(z.string(), z.any()).default({}),\n\n    ipc: z\n      .object({\n        autoInit: z.boolean().default(true),\n      })\n      .default({ autoInit: true }),\n\n    store: z.record(z.string(), z.any()).default({}),\n\n    ipcSetup: z.function().optional(),\n    ipcTransport: z.any().optional(),\n  })\n  .strict(); // Enforce no unknown keys for stricter validation\n\n/**\n * Validate WindowManagerConfig\n * 验证 WindowManagerConfig\n * @param config - Configuration to validate\n * @returns Validation result\n */\nexport function validateWindowManagerConfig(config: any): {\n  success: boolean;\n  error?: string;\n  data?: z.infer<typeof WindowManagerConfigSchema>;\n} {\n  const result = WindowManagerConfigSchema.safeParse(config);\n  if (!result.success) {\n    // Format Zod errors into a readable string\n    const errorMessage = result.error.issues\n      .map((err) => `${err.path.join('.')}: ${err.message}`)\n      .join('; ');\n\n    return {\n      success: false,\n      error: errorMessage,\n    };\n  }\n  return {\n    success: true,\n    data: result.data,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/core/window/window-manager.type.d.ts

@@ -0,0 +1,365 @@
+import { BrowserWindow, BrowserWindowConstructorOptions } from 'electron';
+import type WindowManager from './WindowManager';
+import type { ILogger } from '@/infrastructure/logger';
+import type StateKeeper from '@/internal/utils/StateKeeper';
+import type { IIpcTransport } from '@/core/ipc/transport/ipc.type';
+import type IpcRouter from '@/core/ipc/IpcRouter';
+import type { MessageBus } from '@/core/message-bus/MessageBus';
+/**
+ * WindowManager Plugin Interface
+ * WindowManager 插件接口
+ */
+export interface WindowManagerPlugin {
+    /**
+     * Plugin name
+     * 插件名称
+     */
+    name: string;
+    /**
+     * Called when plugin is initialized
+     * 插件初始化时调用
+     */
+    onInit?(windowManager: WindowManager): void | Promise<void>;
+    /**
+     * Called before window creation. Return false to cancel creation.
+     * 窗口创建前调用。返回 false 取消创建。
+     * Note: Must be synchronous to keep create() synchronous.
+     * 注意：必须是同步的，以保持 create() 同步。
+     */
+    onWillCreate?(config: WindowCreationOptions): WindowCreationOptions | void | false;
+    /**
+     * Called after window creation
+     * 窗口创建后调用
+     */
+    onDidCreate?(details: {
+        window: BrowserWindow;
+        id: string;
+        name?: string;
+    }): void | Promise<void>;
+    /**
+     * Called before window destruction
+     * 窗口销毁前调用
+     */
+    onWillDestroy?(windowId: string): void | Promise<void>;
+    /**
+     * Called after window destruction
+     * 窗口销毁后调用
+     */
+    onDidDestroy?(windowId: string): void | Promise<void>;
+}
+/**
+ * Lifecycle Hooks Interface
+ * 生命周期钩子接口
+ */
+export interface LifecycleHooks {
+    onWillCreate?: (config: WindowCreationOptions) => WindowCreationOptions | void | false;
+    onDidCreate?: (details: {
+        window: BrowserWindow;
+        id: string;
+        name?: string;
+    }) => void | Promise<void>;
+    onWillDestroy?: (windowId: string) => void | Promise<void>;
+    onDidDestroy?: (windowId: string) => void | Promise<void>;
+}
+/**
+ * Context Persistence Interface
+ * 上下文持久化接口
+ */
+export interface IContextPersistence {
+    save(windowId: string, context: any): Promise<void>;
+    load(windowId: string): Promise<any>;
+    clear(windowId: string): Promise<void>;
+}
+/**
+ * Window Store Options Interface
+ * 窗口存储配置接口
+ */
+export interface WindowStoreOptions {
+    /**
+     * Logger instance
+     * 日志实例
+     */
+    logger?: ILogger;
+    /**
+     * State Keeper instance
+     * 状态保持器实例
+     */
+    stateKeeper?: StateKeeper;
+    /**
+     * Context Persistence Strategy
+     * 上下文持久化策略
+     */
+    contextPersistence?: IContextPersistence;
+    /**
+     * Maximum number of windows allowed
+     * 允许的最大窗口数量
+     */
+    maxWindows?: number;
+    /**
+     * Interval for cleaning up destroyed windows (in ms)
+     * 清理已销毁窗口的间隔（毫秒）
+     */
+    cleanupInterval?: number;
+    /**
+     * Whether to enable window state persistence
+     * 是否启用窗口状态持久化
+     */
+    enablePersistence?: boolean;
+    /**
+     * Whether to automatically start cleanup protection (default: true)
+     * 是否自动启动清理保护（默认：true）
+     */
+    autoStartCleanup?: boolean;
+}
+/**
+ * Custom Window Creation Options
+ * 自定义窗口创建选项
+ */
+export interface WindowCreationOptions extends BrowserWindowConstructorOptions {
+    /**
+     * Unique window identifier
+     * 唯一窗口标识符
+     */
+    windowId?: string;
+    /**
+     * Window semantic name
+     * 窗口语义化名称
+     */
+    name?: string;
+    /**
+     * Whether to open DevTools in development
+     * 是否在开发模式下打开开发者工具
+     */
+    isDevelopment?: boolean;
+    /**
+     * Default configuration to inherit from
+     * 要继承的默认配置
+     */
+    defaultConfig?: BrowserWindowConstructorOptions;
+    /**
+     * URL to load immediately after window creation
+     * 窗口创建后立即加载的 URL
+     */
+    loadUrl?: string;
+    /**
+     * Local file path to load immediately after window creation
+     * 窗口创建后立即加载的本地文件路径
+     */
+    loadFile?: string;
+    /**
+     * Custom content loading handler
+     * 自定义内容加载处理程序
+     * If provided, loadUrl and loadFile will be ignored by default handler.
+     * 如果提供，loadUrl 和 loadFile 将被默认处理程序忽略。
+     */
+    loadWindowContent?: (window: BrowserWindow) => Promise<void> | void;
+    /**
+     * Additional custom properties
+     * 其他自定义属性
+     */
+    [key: string]: any;
+    /**
+     * Whether to enable state persistence for this window
+     * 是否为此窗口启用状态持久化
+     */
+    enablePersistence?: boolean;
+}
+/**
+ * WindowManager Events Interface
+ * WindowManager 事件接口
+ */
+export interface WindowManagerEvents {
+    /**
+     * Emitted when an error occurs
+     * 当发生错误时触发
+     */
+    error: (error: Error) => void;
+    /**
+     * Emitted after a window is created
+     * 窗口创建后触发
+     */
+    'window-created': (details: {
+        window: BrowserWindow;
+        id: string;
+        name: string;
+    }) => void;
+    /**
+     * Emitted after a window is destroyed
+     * 窗口销毁后触发
+     */
+    'window-destroyed': (id: string) => void;
+    /**
+     * Emitted before a window is destroyed
+     * 窗口销毁前触发
+     */
+    'window-will-be-destroyed': (id: string) => void;
+}
+/**
+ * Window Manager API Interface (for internal use)
+ * 窗口管理器 API 接口（内部使用）
+ */
+export interface WindowManagerApi {
+    /**
+     * Window operations namespace
+     * 窗口操作命名空间
+     */
+    window: {
+        /**
+         * Check if window exists by ID
+         * 检查指定 ID 的窗口是否存在
+         */
+        hasById(id: string): boolean;
+        /**
+         * Check if window is destroyed
+         * 检查窗口是否已销毁
+         */
+        isDestroyed(id: string): boolean;
+        /**
+         * Delete window by name
+         * 根据名称删除窗口
+         */
+        deleteByName(name: string): boolean;
+        /**
+         * Delete window by ID
+         * 根据 ID 删除窗口
+         */
+        deleteById(id: string): boolean;
+        /**
+         * Get target window by ID
+         * 获取目标窗口
+         */
+        getTargetWindow(id: string): BrowserWindow | undefined;
+        /**
+         * Remove window
+         * 移除窗口
+         */
+        removeWindow(id: string): void | Promise<void>;
+        /**
+         * Show window
+         * 显示窗口
+         */
+        show(window: BrowserWindow, id: string): void;
+    };
+}
+/**
+ * Window Manager Configuration Interface
+ * 窗口管理器配置接口
+ *
+ * Note: Uses 'any' for external dependencies to keep the module independent
+ * 注意：对外部依赖使用 'any' 类型以保持模块独立性
+ */
+export interface WindowManagerConfig {
+    /**
+     * Default browser window options
+     * 默认浏览器窗口选项
+     */
+    defaultConfig?: BrowserWindowConstructorOptions;
+    /**
+     * Development mode flag
+     * 开发模式标志
+     */
+    isDevelopment?: boolean;
+    /**
+     * Linux platform flag
+     * Linux 平台标志
+     */
+    isLinux?: boolean;
+    /**
+     * Logger instance
+     * 日志实例
+     */
+    logger?: ILogger;
+    /**
+     * IpcRouter instance for dependency injection
+     * 用于依赖注入的 IpcRouter 实例
+     */
+    ipcRouter?: IpcRouter;
+    /**
+     * IpcTransport instance
+     * IpcTransport 实例
+     */
+    ipcTransport?: IIpcTransport;
+    /**
+     * MessageBus instance for dependency injection
+     * 用于依赖注入的 MessageBus 实例
+     */
+    messageBus?: MessageBus;
+    /**
+     * IPC configuration
+     * IPC 配置
+     */
+    ipc?: {
+        /**
+         * Whether to automatically initialize IPC on instantiation, default is true
+         * 是否在实例化时自动初始化 IPC，默认为 true
+         */
+        autoInit?: boolean;
+        /**
+         * Async communication channel name, default is 'renderer-to-main'
+         * 异步通信频道名称，默认为 'renderer-to-main'
+         */
+        channel?: string;
+        /**
+         * Sync communication channel name, default is 'renderer-to-main-sync'
+         * 同步通信频道名称，默认为 'renderer-to-main-sync'
+         */
+        syncChannel?: string;
+    };
+    /**
+     * Optional custom IPC setup function
+     * 可选的自定义 IPC 设置函数
+     */
+    ipcSetup?: (windowManager: WindowManager, options?: {
+        channel?: string;
+        syncChannel?: string;
+    }) => {
+        channel: string;
+        syncChannel: string;
+        ipcTransport?: IIpcTransport;
+    };
+    /**
+     * Whether to prevent external links from opening in the window (default: true)
+     * 是否阻止在窗口中打开外部链接（默认：true）
+     */
+    preventExternalLinks?: boolean;
+    /**
+     * Plugins list
+     * 插件列表
+     */
+    plugins?: WindowManagerPlugin[];
+    /**
+     * Lifecycle hooks
+     * 生命周期钩子
+     */
+    hooks?: LifecycleHooks;
+    /**
+     * WindowStore configuration (nested)
+     * WindowStore 配置（嵌套）
+     */
+    store?: WindowStoreOptions;
+    /**
+     * Global custom content loader
+     * 全局自定义内容加载器
+     * Fallback for when no specific loadWindowContent is provided in window options
+     * 当窗口选项中未提供特定 loadWindowContent 时的后备
+     */
+    contentLoader?: (window: BrowserWindow, options: WindowCreationOptions) => Promise<void> | void;
+}
+/**
+ * Frame Interface
+ * 窗口框架接口
+ */
+export interface Frame {
+    /**
+     * Create window
+     * 创建窗口
+     */
+    create(config?: WindowCreationOptions): string;
+}
+/**
+ * Frame Constructor Interface
+ * 窗口框架构造函数接口
+ */
+export interface FrameConstructor {
+    new (): Frame;
+}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import WindowManager from './core/window/WindowManager';
+import IpcRouter from './core/ipc/IpcRouter';
+import { MessageBus } from './core/message-bus/MessageBus';
+import { WindowManagerConfig } from './core/window/window-manager.type';
+/**
+ * Quick Start Helper
+ * 快速开始助手
+ * @param config - WindowManager configuration
+ * @returns Object containing initialized instances
+ */
+export declare function createElectronToolkit(config?: WindowManagerConfig): {
+    windowManager: WindowManager;
+    ipcRouter: IpcRouter<Record<string, any>, Record<string, import("./types").IpcDefinition<any, any>>>;
+    messageBus: MessageBus;
+};
+export * from './core/window';
+export * from './core/ipc';
+export * from './core/message-bus';
+export * from './core/lifecycle/LifecycleManager';
+export { Logger, type LoggerOptions } from './infrastructure/logger';
+export * from './preload';
+export * from './infrastructure/config';
+export * as Types from './types';
+export { DebugHelper, debugHelper, EnhancedDebugHelper } from './infrastructure/debug';
+export * from './infrastructure/errors';