@huyooo/file-explorer-bridge-electron 0.3.0 → 0.4.2

package/dist/main/index.cjs

@@ -40,8 +40,11 @@ var import_electron = require("electron");
 var import_node_path = __toESM(require("path"), 1);
 var import_file_explorer_core = require("@huyooo/file-explorer-core");
 var import_node_fs = require("fs");
+var import_path = require("@huyooo/file-explorer-preview/path");
 var CHANNEL_PREFIX = "file-explorer";
+var PREVIEW_CHANNEL_PREFIX = "file-explorer-preview";
 var channel = (name) => `${CHANNEL_PREFIX}:${name}`;
+var previewChannel = (name) => `${PREVIEW_CHANNEL_PREFIX}:${name}`;
 var clipboardAdapter = null;
 function setClipboardAdapter(adapter) {
   clipboardAdapter = adapter;
@@ -57,7 +60,10 @@ function createElectronAdapter() {
   };
 }
 var electronUrlEncoder = import_file_explorer_core.encodeFileUrl;
-function registerFileExplorerHandlers() {
+var explorerOptions = {};
+var mediaPreviewWindows = /* @__PURE__ */ new Map();
+function registerFileExplorerHandlers(options = {}) {
+  explorerOptions = options;
   const adapter = createElectronAdapter();
   import_electron.ipcMain.handle(channel("readDirectory"), async (_event, dirPath) => {
     const thumbnailService = (0, import_file_explorer_core.getThumbnailService)();
@@ -221,6 +227,282 @@ function registerFileExplorerHandlers() {
     }, 100);
     return { success: true };
   });
+  import_electron.ipcMain.handle(channel("compressFiles"), async (event, sources, options2) => {
+    try {
+      const result = await (0, import_file_explorer_core.compressFiles)(sources, options2, (progress) => {
+        event.sender.send(channel("compressProgress"), progress);
+      });
+      return result;
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("extractArchive"), async (event, archivePath, options2) => {
+    try {
+      const result = await (0, import_file_explorer_core.extractArchive)(archivePath, options2, (progress) => {
+        event.sender.send(channel("extractProgress"), progress);
+      });
+      return result;
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("isArchiveFile"), async (_event, filePath) => {
+    return (0, import_file_explorer_core.isArchiveFile)(filePath);
+  });
+  const watchUnsubscribers = /* @__PURE__ */ new Map();
+  import_electron.ipcMain.handle(channel("watchDirectory"), async (event, dirPath, watchId) => {
+    try {
+      const existingUnsubscribe = watchUnsubscribers.get(watchId);
+      if (existingUnsubscribe) {
+        existingUnsubscribe();
+        watchUnsubscribers.delete(watchId);
+      }
+      const watchManager = (0, import_file_explorer_core.getWatchManager)();
+      const unsubscribe = watchManager.watch(dirPath, (watchEvent) => {
+        event.sender.send(channel("watchEvent"), {
+          watchId,
+          event: watchEvent
+        });
+      });
+      watchUnsubscribers.set(watchId, unsubscribe);
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("unwatchDirectory"), async (_event, watchId) => {
+    const unsubscribe = watchUnsubscribers.get(watchId);
+    if (unsubscribe) {
+      unsubscribe();
+      watchUnsubscribers.delete(watchId);
+    }
+    return { success: true };
+  });
+  import_electron.ipcMain.handle(channel("showFileInfo"), async (_event, filePath) => {
+    return await (0, import_file_explorer_core.showFileInfo)(filePath);
+  });
+  import_electron.ipcMain.handle(channel("openInTerminal"), async (_event, dirPath) => {
+    return await (0, import_file_explorer_core.openInTerminal)(dirPath);
+  });
+  import_electron.ipcMain.handle(channel("openInEditor"), async (_event, targetPath) => {
+    return await (0, import_file_explorer_core.openInEditor)(targetPath);
+  });
+  import_electron.ipcMain.handle(channel("openInNewWindow"), async (_event, folderPath) => {
+    try {
+      if (explorerOptions.onOpenInNewWindow) {
+        explorerOptions.onOpenInNewWindow(folderPath);
+      } else {
+        await import_electron.shell.openPath(folderPath);
+      }
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.on(channel("requestWindowFocus"), (event) => {
+    const win = import_electron.BrowserWindow.fromWebContents(event.sender);
+    if (win && !win.isFocused()) {
+      win.focus();
+    }
+  });
+  import_electron.ipcMain.handle(channel("mediaNeedsTranscode"), async (_event, filePath) => {
+    const mediaService = (0, import_file_explorer_core.getMediaService)();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      const info = await mediaService.needsTranscode(filePath);
+      return { success: true, data: info };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("mediaGetPlayableUrl"), async (event, filePath) => {
+    const mediaService = (0, import_file_explorer_core.getMediaService)();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      const url = await mediaService.getPlayableUrl(filePath, (progress) => {
+        event.sender.send(channel("mediaTranscodeProgress"), {
+          filePath,
+          progress
+        });
+      });
+      return { success: true, url };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("mediaGetMetadata"), async (_event, filePath) => {
+    const mediaService = (0, import_file_explorer_core.getMediaService)();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      const metadata = await mediaService.getMetadata(filePath);
+      return { success: true, data: metadata };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("mediaCleanupFile"), async (_event, filePath) => {
+    const mediaService = (0, import_file_explorer_core.getMediaService)();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      await mediaService.cleanupFile(filePath);
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("openMediaPreviewWindow"), async (event, filePath, mediaType) => {
+    try {
+      const fileName = import_node_path.default.basename(filePath);
+      const mediaService = (0, import_file_explorer_core.getMediaService)();
+      let fileUrl;
+      if (mediaType === "image") {
+        fileUrl = electronUrlEncoder(filePath);
+      } else if (mediaService) {
+        const playableUrl = await mediaService.getPlayableUrl(filePath, (progress) => {
+          event.sender.send(channel("mediaTranscodeProgress"), {
+            filePath,
+            progress
+          });
+        });
+        fileUrl = playableUrl || electronUrlEncoder(filePath);
+      } else {
+        fileUrl = electronUrlEncoder(filePath);
+      }
+      const existingWindow = mediaPreviewWindows.get(filePath);
+      if (existingWindow && !existingWindow.isDestroyed()) {
+        existingWindow.focus();
+        return { success: true };
+      }
+      const isMac = process.platform === "darwin";
+      const isWin = process.platform === "win32";
+      const titleBarHeight = isMac ? 38 : 32;
+      let contentWidth = 720;
+      let contentHeight = 405;
+      let minContentWidth = 720;
+      let minContentHeight = 405;
+      if (mediaType === "audio") {
+        contentWidth = 720;
+        contentHeight = 405;
+        minContentWidth = 720;
+        minContentHeight = 405;
+      } else if (mediaType === "image") {
+        contentWidth = 1e3;
+        contentHeight = 700;
+        minContentWidth = 600;
+        minContentHeight = 400;
+      }
+      const width = contentWidth;
+      const height = contentHeight + titleBarHeight;
+      const minWidth = minContentWidth;
+      const minHeight = minContentHeight + titleBarHeight;
+      const previewPreloadPath = import_node_path.default.join(__dirname, "../preload/preview.cjs");
+      const previewWindow = new import_electron.BrowserWindow({
+        width,
+        height,
+        minWidth,
+        minHeight,
+        title: fileName,
+        modal: false,
+        show: false,
+        backgroundColor: "#1a1a1a",
+        // 窗口功能
+        resizable: true,
+        maximizable: true,
+        fullscreenable: true,
+        // Windows 和 macOS 都使用无边框样式，自定义标题栏
+        frame: isMac ? true : false,
+        // macOS 用 hiddenInset，Windows 完全无边框
+        titleBarStyle: isMac ? "hiddenInset" : void 0,
+        trafficLightPosition: isMac ? { x: 12, y: 12 } : void 0,
+        webPreferences: {
+          preload: previewPreloadPath,
+          nodeIntegration: false,
+          contextIsolation: true,
+          // 注意：以下设置会触发安全警告，但这是必要的
+          // - sandbox: false - 需要加载本地媒体文件（file:// 协议）
+          // - webSecurity: false - 允许加载本地文件和 Iconify CDN
+          // 这些警告在开发环境中显示，打包后不会显示
+          sandbox: false,
+          webSecurity: false
+        }
+      });
+      const previewHtmlPath = (0, import_path.getPreviewHtmlPath)();
+      const searchParams = new URLSearchParams({
+        type: mediaType,
+        url: encodeURIComponent(fileUrl),
+        name: encodeURIComponent(fileName),
+        platform: isMac ? "darwin" : isWin ? "win32" : "linux"
+      });
+      previewWindow.loadFile(previewHtmlPath, { search: searchParams.toString() });
+      previewWindow.once("ready-to-show", () => {
+        previewWindow.show();
+      });
+      previewWindow.on("maximize", () => {
+        previewWindow.webContents.send(previewChannel("maximizeChange"), true);
+      });
+      previewWindow.on("unmaximize", () => {
+        previewWindow.webContents.send(previewChannel("maximizeChange"), false);
+      });
+      previewWindow.on("closed", () => {
+        mediaPreviewWindows.delete(filePath);
+      });
+      mediaPreviewWindows.set(filePath, previewWindow);
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  import_electron.ipcMain.handle(channel("closeMediaPreviewWindow"), async (_event, filePath) => {
+    const window = mediaPreviewWindows.get(filePath);
+    if (window && !window.isDestroyed()) {
+      window.close();
+      mediaPreviewWindows.delete(filePath);
+    }
+    return { success: true };
+  });
+  import_electron.ipcMain.on(previewChannel("minimize"), (event) => {
+    const win = import_electron.BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.minimize();
+    }
+  });
+  import_electron.ipcMain.on(previewChannel("toggleMaximize"), (event) => {
+    const win = import_electron.BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      if (win.isMaximized()) {
+        win.unmaximize();
+      } else {
+        win.maximize();
+      }
+    }
+  });
+  import_electron.ipcMain.on(previewChannel("close"), (event) => {
+    const win = import_electron.BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.close();
+    }
+  });
+  import_electron.ipcMain.on(previewChannel("hide"), (event) => {
+    const win = import_electron.BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.hide();
+    }
+  });
+  import_electron.ipcMain.on(previewChannel("show"), (event) => {
+    const win = import_electron.BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.show();
+    }
+  });
   console.log("\u2705 File Explorer IPC handlers registered");
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/main/index.d.cts

@@ -17,9 +17,15 @@ declare function setClipboardAdapter(adapter: ClipboardAdapter): void;
 declare function createElectronAdapter(): PlatformAdapter;
 /** URL 编码器（使用 core 中的协议工具） */
 declare const electronUrlEncoder: typeof encodeFileUrl;
+/** 文件管理器配置选项 */
+interface FileExplorerOptions {
+    /** 在新窗口中打开文件夹的回调 */
+    onOpenInNewWindow?: (folderPath: string) => void;
+}
 /**
  * 注册文件系统 IPC handlers
+ * @param options 可选配置
  */
-declare function registerFileExplorerHandlers(): void;
+declare function registerFileExplorerHandlers(options?: FileExplorerOptions): void;
 
-export { createElectronAdapter, electronUrlEncoder, registerFileExplorerHandlers, setClipboardAdapter };
+export { type FileExplorerOptions, createElectronAdapter, electronUrlEncoder, registerFileExplorerHandlers, setClipboardAdapter };

package/dist/main/index.d.ts

@@ -17,9 +17,15 @@ declare function setClipboardAdapter(adapter: ClipboardAdapter): void;
 declare function createElectronAdapter(): PlatformAdapter;
 /** URL 编码器（使用 core 中的协议工具） */
 declare const electronUrlEncoder: typeof encodeFileUrl;
+/** 文件管理器配置选项 */
+interface FileExplorerOptions {
+    /** 在新窗口中打开文件夹的回调 */
+    onOpenInNewWindow?: (folderPath: string) => void;
+}
 /**
  * 注册文件系统 IPC handlers
+ * @param options 可选配置
  */
-declare function registerFileExplorerHandlers(): void;
+declare function registerFileExplorerHandlers(options?: FileExplorerOptions): void;
 
-export { createElectronAdapter, electronUrlEncoder, registerFileExplorerHandlers, setClipboardAdapter };
+export { type FileExplorerOptions, createElectronAdapter, electronUrlEncoder, registerFileExplorerHandlers, setClipboardAdapter };

package/dist/main/index.js

@@ -1,5 +1,5 @@
 // src/main/index.ts
-import { ipcMain, shell } from "electron";
+import { ipcMain, shell, BrowserWindow } from "electron";
 import path from "path";
 import {
   readDirectory,
@@ -21,14 +21,25 @@ import {
   pasteFiles,
   searchFiles,
   searchFilesStream,
+  compressFiles,
+  extractArchive,
+  isArchiveFile,
+  getWatchManager,
+  showFileInfo,
+  openInTerminal,
+  openInEditor,
   getFileType,
   formatFileSize,
   formatDateTime,
-  encodeFileUrl
+  encodeFileUrl,
+  getMediaService
 } from "@huyooo/file-explorer-core";
 import { promises as fs } from "fs";
+import { getPreviewHtmlPath } from "@huyooo/file-explorer-preview/path";
 var CHANNEL_PREFIX = "file-explorer";
+var PREVIEW_CHANNEL_PREFIX = "file-explorer-preview";
 var channel = (name) => `${CHANNEL_PREFIX}:${name}`;
+var previewChannel = (name) => `${PREVIEW_CHANNEL_PREFIX}:${name}`;
 var clipboardAdapter = null;
 function setClipboardAdapter(adapter) {
   clipboardAdapter = adapter;
@@ -44,7 +55,10 @@ function createElectronAdapter() {
   };
 }
 var electronUrlEncoder = encodeFileUrl;
-function registerFileExplorerHandlers() {
+var explorerOptions = {};
+var mediaPreviewWindows = /* @__PURE__ */ new Map();
+function registerFileExplorerHandlers(options = {}) {
+  explorerOptions = options;
   const adapter = createElectronAdapter();
   ipcMain.handle(channel("readDirectory"), async (_event, dirPath) => {
     const thumbnailService = getThumbnailService();
@@ -208,6 +222,282 @@ function registerFileExplorerHandlers() {
     }, 100);
     return { success: true };
   });
+  ipcMain.handle(channel("compressFiles"), async (event, sources, options2) => {
+    try {
+      const result = await compressFiles(sources, options2, (progress) => {
+        event.sender.send(channel("compressProgress"), progress);
+      });
+      return result;
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("extractArchive"), async (event, archivePath, options2) => {
+    try {
+      const result = await extractArchive(archivePath, options2, (progress) => {
+        event.sender.send(channel("extractProgress"), progress);
+      });
+      return result;
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("isArchiveFile"), async (_event, filePath) => {
+    return isArchiveFile(filePath);
+  });
+  const watchUnsubscribers = /* @__PURE__ */ new Map();
+  ipcMain.handle(channel("watchDirectory"), async (event, dirPath, watchId) => {
+    try {
+      const existingUnsubscribe = watchUnsubscribers.get(watchId);
+      if (existingUnsubscribe) {
+        existingUnsubscribe();
+        watchUnsubscribers.delete(watchId);
+      }
+      const watchManager = getWatchManager();
+      const unsubscribe = watchManager.watch(dirPath, (watchEvent) => {
+        event.sender.send(channel("watchEvent"), {
+          watchId,
+          event: watchEvent
+        });
+      });
+      watchUnsubscribers.set(watchId, unsubscribe);
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("unwatchDirectory"), async (_event, watchId) => {
+    const unsubscribe = watchUnsubscribers.get(watchId);
+    if (unsubscribe) {
+      unsubscribe();
+      watchUnsubscribers.delete(watchId);
+    }
+    return { success: true };
+  });
+  ipcMain.handle(channel("showFileInfo"), async (_event, filePath) => {
+    return await showFileInfo(filePath);
+  });
+  ipcMain.handle(channel("openInTerminal"), async (_event, dirPath) => {
+    return await openInTerminal(dirPath);
+  });
+  ipcMain.handle(channel("openInEditor"), async (_event, targetPath) => {
+    return await openInEditor(targetPath);
+  });
+  ipcMain.handle(channel("openInNewWindow"), async (_event, folderPath) => {
+    try {
+      if (explorerOptions.onOpenInNewWindow) {
+        explorerOptions.onOpenInNewWindow(folderPath);
+      } else {
+        await shell.openPath(folderPath);
+      }
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.on(channel("requestWindowFocus"), (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win && !win.isFocused()) {
+      win.focus();
+    }
+  });
+  ipcMain.handle(channel("mediaNeedsTranscode"), async (_event, filePath) => {
+    const mediaService = getMediaService();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      const info = await mediaService.needsTranscode(filePath);
+      return { success: true, data: info };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("mediaGetPlayableUrl"), async (event, filePath) => {
+    const mediaService = getMediaService();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      const url = await mediaService.getPlayableUrl(filePath, (progress) => {
+        event.sender.send(channel("mediaTranscodeProgress"), {
+          filePath,
+          progress
+        });
+      });
+      return { success: true, url };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("mediaGetMetadata"), async (_event, filePath) => {
+    const mediaService = getMediaService();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      const metadata = await mediaService.getMetadata(filePath);
+      return { success: true, data: metadata };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("mediaCleanupFile"), async (_event, filePath) => {
+    const mediaService = getMediaService();
+    if (!mediaService) {
+      return { success: false, error: "\u5A92\u4F53\u670D\u52A1\u672A\u521D\u59CB\u5316" };
+    }
+    try {
+      await mediaService.cleanupFile(filePath);
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("openMediaPreviewWindow"), async (event, filePath, mediaType) => {
+    try {
+      const fileName = path.basename(filePath);
+      const mediaService = getMediaService();
+      let fileUrl;
+      if (mediaType === "image") {
+        fileUrl = electronUrlEncoder(filePath);
+      } else if (mediaService) {
+        const playableUrl = await mediaService.getPlayableUrl(filePath, (progress) => {
+          event.sender.send(channel("mediaTranscodeProgress"), {
+            filePath,
+            progress
+          });
+        });
+        fileUrl = playableUrl || electronUrlEncoder(filePath);
+      } else {
+        fileUrl = electronUrlEncoder(filePath);
+      }
+      const existingWindow = mediaPreviewWindows.get(filePath);
+      if (existingWindow && !existingWindow.isDestroyed()) {
+        existingWindow.focus();
+        return { success: true };
+      }
+      const isMac = process.platform === "darwin";
+      const isWin = process.platform === "win32";
+      const titleBarHeight = isMac ? 38 : 32;
+      let contentWidth = 720;
+      let contentHeight = 405;
+      let minContentWidth = 720;
+      let minContentHeight = 405;
+      if (mediaType === "audio") {
+        contentWidth = 720;
+        contentHeight = 405;
+        minContentWidth = 720;
+        minContentHeight = 405;
+      } else if (mediaType === "image") {
+        contentWidth = 1e3;
+        contentHeight = 700;
+        minContentWidth = 600;
+        minContentHeight = 400;
+      }
+      const width = contentWidth;
+      const height = contentHeight + titleBarHeight;
+      const minWidth = minContentWidth;
+      const minHeight = minContentHeight + titleBarHeight;
+      const previewPreloadPath = path.join(__dirname, "../preload/preview.cjs");
+      const previewWindow = new BrowserWindow({
+        width,
+        height,
+        minWidth,
+        minHeight,
+        title: fileName,
+        modal: false,
+        show: false,
+        backgroundColor: "#1a1a1a",
+        // 窗口功能
+        resizable: true,
+        maximizable: true,
+        fullscreenable: true,
+        // Windows 和 macOS 都使用无边框样式，自定义标题栏
+        frame: isMac ? true : false,
+        // macOS 用 hiddenInset，Windows 完全无边框
+        titleBarStyle: isMac ? "hiddenInset" : void 0,
+        trafficLightPosition: isMac ? { x: 12, y: 12 } : void 0,
+        webPreferences: {
+          preload: previewPreloadPath,
+          nodeIntegration: false,
+          contextIsolation: true,
+          // 注意：以下设置会触发安全警告，但这是必要的
+          // - sandbox: false - 需要加载本地媒体文件（file:// 协议）
+          // - webSecurity: false - 允许加载本地文件和 Iconify CDN
+          // 这些警告在开发环境中显示，打包后不会显示
+          sandbox: false,
+          webSecurity: false
+        }
+      });
+      const previewHtmlPath = getPreviewHtmlPath();
+      const searchParams = new URLSearchParams({
+        type: mediaType,
+        url: encodeURIComponent(fileUrl),
+        name: encodeURIComponent(fileName),
+        platform: isMac ? "darwin" : isWin ? "win32" : "linux"
+      });
+      previewWindow.loadFile(previewHtmlPath, { search: searchParams.toString() });
+      previewWindow.once("ready-to-show", () => {
+        previewWindow.show();
+      });
+      previewWindow.on("maximize", () => {
+        previewWindow.webContents.send(previewChannel("maximizeChange"), true);
+      });
+      previewWindow.on("unmaximize", () => {
+        previewWindow.webContents.send(previewChannel("maximizeChange"), false);
+      });
+      previewWindow.on("closed", () => {
+        mediaPreviewWindows.delete(filePath);
+      });
+      mediaPreviewWindows.set(filePath, previewWindow);
+      return { success: true };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  });
+  ipcMain.handle(channel("closeMediaPreviewWindow"), async (_event, filePath) => {
+    const window = mediaPreviewWindows.get(filePath);
+    if (window && !window.isDestroyed()) {
+      window.close();
+      mediaPreviewWindows.delete(filePath);
+    }
+    return { success: true };
+  });
+  ipcMain.on(previewChannel("minimize"), (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.minimize();
+    }
+  });
+  ipcMain.on(previewChannel("toggleMaximize"), (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      if (win.isMaximized()) {
+        win.unmaximize();
+      } else {
+        win.maximize();
+      }
+    }
+  });
+  ipcMain.on(previewChannel("close"), (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.close();
+    }
+  });
+  ipcMain.on(previewChannel("hide"), (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.hide();
+    }
+  });
+  ipcMain.on(previewChannel("show"), (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win) {
+      win.show();
+    }
+  });
   console.log("\u2705 File Explorer IPC handlers registered");
 }
 export {