@huyooo/file-explorer-bridge-electron 0.4.5 → 0.4.10

package/dist/main/index.cjs

@@ -30,21 +30,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/main/index.ts
 var main_exports = {};
 __export(main_exports, {
-  createElectronAdapter: () => createElectronAdapter,
-  electronUrlEncoder: () => electronUrlEncoder,
-  registerFileExplorerHandlers: () => registerFileExplorerHandlers,
-  setClipboardAdapter: () => setClipboardAdapter
+  registerFileExplorer: () => registerFileExplorer
 });
 module.exports = __toCommonJS(main_exports);
 var import_electron = require("electron");
 var import_node_path = __toESM(require("path"), 1);
+var import_node_url = require("url");
 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 import_meta = {};
+var DEFAULT_CHANNEL_PREFIX = "file-explorer";
+var DEFAULT_PREVIEW_CHANNEL_PREFIX = "file-explorer-preview";
+var __dirname = import_node_path.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url));
 var clipboardAdapter = null;
 function setClipboardAdapter(adapter) {
   clipboardAdapter = adapter;
@@ -64,6 +62,10 @@ var explorerOptions = {};
 var mediaPreviewWindows = /* @__PURE__ */ new Map();
 function registerFileExplorerHandlers(options = {}) {
   explorerOptions = options;
+  const channelPrefix = options.channelPrefix || DEFAULT_CHANNEL_PREFIX;
+  const previewChannelPrefix = options.previewChannelPrefix || DEFAULT_PREVIEW_CHANNEL_PREFIX;
+  const channel = (name) => `${channelPrefix}:${name}`;
+  const previewChannel = (name) => `${previewChannelPrefix}:${name}`;
   const adapter = createElectronAdapter();
   import_electron.ipcMain.handle(channel("readDirectory"), async (_event, dirPath) => {
     const thumbnailService = (0, import_file_explorer_core.getThumbnailService)();
@@ -505,10 +507,13 @@ function registerFileExplorerHandlers(options = {}) {
   });
   console.log("\u2705 File Explorer IPC handlers registered");
 }
+function registerFileExplorer(options = {}) {
+  if (options.clipboardAdapter) {
+    setClipboardAdapter(options.clipboardAdapter);
+  }
+  registerFileExplorerHandlers(options);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createElectronAdapter,
-  electronUrlEncoder,
-  registerFileExplorerHandlers,
-  setClipboardAdapter
+  registerFileExplorer
 });

package/dist/main/index.d.cts

@@ -1,4 +1,4 @@
-import { PlatformAdapter, encodeFileUrl, ClipboardAdapter } from '@huyooo/file-explorer-core';
+import { ClipboardAdapter } from '@huyooo/file-explorer-core';
 
 /**
  * File Explorer Electron Bridge - Main Process
@@ -6,26 +6,25 @@ import { PlatformAdapter, encodeFileUrl, ClipboardAdapter } from '@huyooo/file-e
  * 只负责 IPC 通信，具体实现在 @huyooo/file-explorer-core 中
  */
 
-/**
- * 设置剪贴板适配器
- * 在主进程中调用，注入 clipboard-files 模块
- */
-declare function setClipboardAdapter(adapter: ClipboardAdapter): void;
-/**
- * 创建 Electron 平台适配器
- */
-declare function createElectronAdapter(): PlatformAdapter;
-/** URL 编码器（使用 core 中的协议工具） */
-declare const electronUrlEncoder: typeof encodeFileUrl;
 /** 文件管理器配置选项 */
 interface FileExplorerOptions {
     /** 在新窗口中打开文件夹的回调 */
     onOpenInNewWindow?: (folderPath: string) => void;
+    /** IPC 通道名称前缀（允许宿主自定义，避免冲突） */
+    channelPrefix?: string;
+    /** 预览窗口 IPC 通道前缀（一般不需要改） */
+    previewChannelPrefix?: string;
+}
+interface RegisterFileExplorerOptions extends FileExplorerOptions {
+    /** 注入剪贴板适配器（例如 clipboard-files） */
+    clipboardAdapter?: ClipboardAdapter;
 }
 /**
- * 注册文件系统 IPC handlers
- * @param options 可选配置
+ * 高层入口：注册 File Explorer（主进程）
+ *
+ * - 可选注入 `clipboardAdapter`
+ * - 可选自定义 `channelPrefix` 避免多实例冲突
  */
-declare function registerFileExplorerHandlers(options?: FileExplorerOptions): void;
+declare function registerFileExplorer(options?: RegisterFileExplorerOptions): void;
 
-export { type FileExplorerOptions, createElectronAdapter, electronUrlEncoder, registerFileExplorerHandlers, setClipboardAdapter };
+export { type FileExplorerOptions, type RegisterFileExplorerOptions, registerFileExplorer };

package/dist/main/index.d.ts

@@ -1,4 +1,4 @@
-import { PlatformAdapter, encodeFileUrl, ClipboardAdapter } from '@huyooo/file-explorer-core';
+import { ClipboardAdapter } from '@huyooo/file-explorer-core';
 
 /**
  * File Explorer Electron Bridge - Main Process
@@ -6,26 +6,25 @@ import { PlatformAdapter, encodeFileUrl, ClipboardAdapter } from '@huyooo/file-e
  * 只负责 IPC 通信，具体实现在 @huyooo/file-explorer-core 中
  */
 
-/**
- * 设置剪贴板适配器
- * 在主进程中调用，注入 clipboard-files 模块
- */
-declare function setClipboardAdapter(adapter: ClipboardAdapter): void;
-/**
- * 创建 Electron 平台适配器
- */
-declare function createElectronAdapter(): PlatformAdapter;
-/** URL 编码器（使用 core 中的协议工具） */
-declare const electronUrlEncoder: typeof encodeFileUrl;
 /** 文件管理器配置选项 */
 interface FileExplorerOptions {
     /** 在新窗口中打开文件夹的回调 */
     onOpenInNewWindow?: (folderPath: string) => void;
+    /** IPC 通道名称前缀（允许宿主自定义，避免冲突） */
+    channelPrefix?: string;
+    /** 预览窗口 IPC 通道前缀（一般不需要改） */
+    previewChannelPrefix?: string;
+}
+interface RegisterFileExplorerOptions extends FileExplorerOptions {
+    /** 注入剪贴板适配器（例如 clipboard-files） */
+    clipboardAdapter?: ClipboardAdapter;
 }
 /**
- * 注册文件系统 IPC handlers
- * @param options 可选配置
+ * 高层入口：注册 File Explorer（主进程）
+ *
+ * - 可选注入 `clipboardAdapter`
+ * - 可选自定义 `channelPrefix` 避免多实例冲突
  */
-declare function registerFileExplorerHandlers(options?: FileExplorerOptions): void;
+declare function registerFileExplorer(options?: RegisterFileExplorerOptions): void;
 
-export { type FileExplorerOptions, createElectronAdapter, electronUrlEncoder, registerFileExplorerHandlers, setClipboardAdapter };
+export { type FileExplorerOptions, type RegisterFileExplorerOptions, registerFileExplorer };

package/dist/main/index.js

@@ -1,6 +1,8 @@
 // src/main/index.ts
 import { ipcMain, shell, BrowserWindow } from "electron";
 import path from "path";
+import { fileURLToPath } from "url";
+import fsSync from "fs";
 import {
   readDirectory,
   readFileContent,
@@ -36,10 +38,9 @@ import {
 } 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 DEFAULT_CHANNEL_PREFIX = "file-explorer";
+var DEFAULT_PREVIEW_CHANNEL_PREFIX = "file-explorer-preview";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
 var clipboardAdapter = null;
 function setClipboardAdapter(adapter) {
   clipboardAdapter = adapter;
@@ -59,6 +60,10 @@ var explorerOptions = {};
 var mediaPreviewWindows = /* @__PURE__ */ new Map();
 function registerFileExplorerHandlers(options = {}) {
   explorerOptions = options;
+  const channelPrefix = options.channelPrefix || DEFAULT_CHANNEL_PREFIX;
+  const previewChannelPrefix = options.previewChannelPrefix || DEFAULT_PREVIEW_CHANNEL_PREFIX;
+  const channel = (name) => `${channelPrefix}:${name}`;
+  const previewChannel = (name) => `${previewChannelPrefix}:${name}`;
   const adapter = createElectronAdapter();
   ipcMain.handle(channel("readDirectory"), async (_event, dirPath) => {
     const thumbnailService = getThumbnailService();
@@ -400,6 +405,13 @@ function registerFileExplorerHandlers(options = {}) {
       const minWidth = minContentWidth;
       const minHeight = minContentHeight + titleBarHeight;
       const previewPreloadPath = path.join(__dirname, "../preload/preview.cjs");
+      const previewHtmlPath = getPreviewHtmlPath();
+      if (!fsSync.existsSync(previewPreloadPath)) {
+        return { success: false, error: `Preview preload not found: ${previewPreloadPath}` };
+      }
+      if (!fsSync.existsSync(previewHtmlPath)) {
+        return { success: false, error: `Preview html not found: ${previewHtmlPath}` };
+      }
       const previewWindow = new BrowserWindow({
         width,
         height,
@@ -430,7 +442,6 @@ function registerFileExplorerHandlers(options = {}) {
           webSecurity: false
         }
       });
-      const previewHtmlPath = getPreviewHtmlPath();
       const searchParams = new URLSearchParams({
         type: mediaType,
         url: encodeURIComponent(fileUrl),
@@ -500,9 +511,12 @@ function registerFileExplorerHandlers(options = {}) {
   });
   console.log("\u2705 File Explorer IPC handlers registered");
 }
+function registerFileExplorer(options = {}) {
+  if (options.clipboardAdapter) {
+    setClipboardAdapter(options.clipboardAdapter);
+  }
+  registerFileExplorerHandlers(options);
+}
 export {
-  createElectronAdapter,
-  electronUrlEncoder,
-  registerFileExplorerHandlers,
-  setClipboardAdapter
+  registerFileExplorer
 };

package/dist/preload/index.cjs

@@ -20,14 +20,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/preload/index.ts
 var preload_exports = {};
 __export(preload_exports, {
-  createFileExplorerAPI: () => createFileExplorerAPI,
   exposeFileExplorerAPI: () => exposeFileExplorerAPI
 });
 module.exports = __toCommonJS(preload_exports);
 var import_electron = require("electron");
-var CHANNEL_PREFIX = "file-explorer";
-var channel = (name) => `${CHANNEL_PREFIX}:${name}`;
-function createFileExplorerAPI() {
+var DEFAULT_CHANNEL_PREFIX = "file-explorer";
+function createFileExplorerAPI(options = {}) {
+  const channelPrefix = options.channelPrefix || DEFAULT_CHANNEL_PREFIX;
+  const channel = (name) => `${channelPrefix}:${name}`;
   return {
     readDirectory: (dirPath) => import_electron.ipcRenderer.invoke(channel("readDirectory"), dirPath),
     readSystemPath: (pathId) => import_electron.ipcRenderer.invoke(channel("readSystemPath"), pathId),
@@ -57,8 +57,8 @@ function createFileExplorerAPI() {
       import_electron.ipcRenderer.on(channel("searchResults"), handler);
       return () => import_electron.ipcRenderer.removeListener(channel("searchResults"), handler);
     },
-    compressFiles: (sources, options) => import_electron.ipcRenderer.invoke(channel("compressFiles"), sources, options),
-    extractArchive: (archivePath, options) => import_electron.ipcRenderer.invoke(channel("extractArchive"), archivePath, options),
+    compressFiles: (sources, options2) => import_electron.ipcRenderer.invoke(channel("compressFiles"), sources, options2),
+    extractArchive: (archivePath, options2) => import_electron.ipcRenderer.invoke(channel("extractArchive"), archivePath, options2),
     isArchiveFile: (filePath) => import_electron.ipcRenderer.invoke(channel("isArchiveFile"), filePath),
     onCompressProgress: (callback) => {
       const handler = (_event, data) => {
@@ -105,13 +105,13 @@ function createFileExplorerAPI() {
     closeMediaPreviewWindow: (filePath) => import_electron.ipcRenderer.invoke(channel("closeMediaPreviewWindow"), filePath)
   };
 }
-function exposeFileExplorerAPI(apiName = "fileExplorerAPI") {
-  const api = createFileExplorerAPI();
+function exposeFileExplorerAPI(options = {}) {
+  const apiName = options.apiName || "fileExplorerAPI";
+  const api = createFileExplorerAPI({ channelPrefix: options.channelPrefix });
   import_electron.contextBridge.exposeInMainWorld(apiName, api);
   console.log(`\u2705 File Explorer API exposed as window.${apiName}`);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createFileExplorerAPI,
   exposeFileExplorerAPI
 });

package/dist/preload/index.d.cts

@@ -260,19 +260,19 @@ interface FileExplorerAPI {
         error?: string;
     }>;
 }
-/**
- * 创建文件操作 API
- */
-declare function createFileExplorerAPI(): FileExplorerAPI;
 /**
  * 暴露文件操作 API 到渲染进程
  *
  * 在 preload.ts 中调用：
  * ```ts
- * import { exposeFileExplorerAPI } from '@aspect/file-explorer-bridge-electron/preload';
- * exposeFileExplorerAPI();
+ * import { exposeFileExplorerAPI } from '@huyooo/file-explorer-bridge-electron/preload';
+ * exposeFileExplorerAPI({});
  * ```
  */
-declare function exposeFileExplorerAPI(apiName?: string): void;
+interface ExposeFileExplorerAPIOptions {
+    apiName?: string;
+    channelPrefix?: string;
+}
+declare function exposeFileExplorerAPI(options?: ExposeFileExplorerAPIOptions): void;
 
-export { type FileExplorerAPI, createFileExplorerAPI, exposeFileExplorerAPI };
+export { type ExposeFileExplorerAPIOptions, type FileExplorerAPI, exposeFileExplorerAPI };

package/dist/preload/index.d.ts

@@ -260,19 +260,19 @@ interface FileExplorerAPI {
         error?: string;
     }>;
 }
-/**
- * 创建文件操作 API
- */
-declare function createFileExplorerAPI(): FileExplorerAPI;
 /**
  * 暴露文件操作 API 到渲染进程
  *
  * 在 preload.ts 中调用：
  * ```ts
- * import { exposeFileExplorerAPI } from '@aspect/file-explorer-bridge-electron/preload';
- * exposeFileExplorerAPI();
+ * import { exposeFileExplorerAPI } from '@huyooo/file-explorer-bridge-electron/preload';
+ * exposeFileExplorerAPI({});
  * ```
  */
-declare function exposeFileExplorerAPI(apiName?: string): void;
+interface ExposeFileExplorerAPIOptions {
+    apiName?: string;
+    channelPrefix?: string;
+}
+declare function exposeFileExplorerAPI(options?: ExposeFileExplorerAPIOptions): void;
 
-export { type FileExplorerAPI, createFileExplorerAPI, exposeFileExplorerAPI };
+export { type ExposeFileExplorerAPIOptions, type FileExplorerAPI, exposeFileExplorerAPI };

package/dist/preload/index.js

@@ -1,8 +1,9 @@
 // src/preload/index.ts
 import { contextBridge, ipcRenderer } from "electron";
-var CHANNEL_PREFIX = "file-explorer";
-var channel = (name) => `${CHANNEL_PREFIX}:${name}`;
-function createFileExplorerAPI() {
+var DEFAULT_CHANNEL_PREFIX = "file-explorer";
+function createFileExplorerAPI(options = {}) {
+  const channelPrefix = options.channelPrefix || DEFAULT_CHANNEL_PREFIX;
+  const channel = (name) => `${channelPrefix}:${name}`;
   return {
     readDirectory: (dirPath) => ipcRenderer.invoke(channel("readDirectory"), dirPath),
     readSystemPath: (pathId) => ipcRenderer.invoke(channel("readSystemPath"), pathId),
@@ -32,8 +33,8 @@ function createFileExplorerAPI() {
       ipcRenderer.on(channel("searchResults"), handler);
       return () => ipcRenderer.removeListener(channel("searchResults"), handler);
     },
-    compressFiles: (sources, options) => ipcRenderer.invoke(channel("compressFiles"), sources, options),
-    extractArchive: (archivePath, options) => ipcRenderer.invoke(channel("extractArchive"), archivePath, options),
+    compressFiles: (sources, options2) => ipcRenderer.invoke(channel("compressFiles"), sources, options2),
+    extractArchive: (archivePath, options2) => ipcRenderer.invoke(channel("extractArchive"), archivePath, options2),
     isArchiveFile: (filePath) => ipcRenderer.invoke(channel("isArchiveFile"), filePath),
     onCompressProgress: (callback) => {
       const handler = (_event, data) => {
@@ -80,12 +81,12 @@ function createFileExplorerAPI() {
     closeMediaPreviewWindow: (filePath) => ipcRenderer.invoke(channel("closeMediaPreviewWindow"), filePath)
   };
 }
-function exposeFileExplorerAPI(apiName = "fileExplorerAPI") {
-  const api = createFileExplorerAPI();
+function exposeFileExplorerAPI(options = {}) {
+  const apiName = options.apiName || "fileExplorerAPI";
+  const api = createFileExplorerAPI({ channelPrefix: options.channelPrefix });
   contextBridge.exposeInMainWorld(apiName, api);
   console.log(`\u2705 File Explorer API exposed as window.${apiName}`);
 }
 export {
-  createFileExplorerAPI,
   exposeFileExplorerAPI
 };

package/dist/renderer/index.cjs

@@ -20,60 +20,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/renderer/index.ts
 var renderer_exports = {};
 __export(renderer_exports, {
-  createElectronAdapter: () => createElectronAdapter
+  createFileExplorerClient: () => createFileExplorerClient
 });
 module.exports = __toCommonJS(renderer_exports);
-function createElectronAdapter() {
-  const api = window.fileExplorerAPI;
+function createFileExplorerClient(apiName = "fileExplorerAPI") {
+  const api = apiName === "fileExplorerAPI" ? window.fileExplorerAPI : window[apiName];
   if (!api) {
     throw new Error(
-      "window.fileExplorerAPI not found. Make sure to call exposeFileExplorerAPI() in your preload script."
+      `window.${apiName} not found. Make sure to call exposeFileExplorerAPI({ apiName }) in your preload script.`
     );
   }
-  return {
-    readDirectory: (dirPath) => api.readDirectory(dirPath),
-    readSystemPath: (pathId) => api.readSystemPath(pathId),
-    getSystemPath: (pathId) => api.getSystemPath(pathId),
-    readFileContent: (filePath) => api.readFileContent(filePath),
-    writeFileContent: (filePath, content) => api.writeFileContent(filePath, content),
-    createFolder: (parentDir, folderName) => api.createFolder(parentDir, folderName),
-    createFile: (parentDir, fileName, content) => api.createFile(parentDir, fileName, content),
-    deleteFiles: (paths) => api.deleteFiles(paths),
-    renameFile: (oldPath, newPath) => api.renameFile(oldPath, newPath),
-    copyFiles: (sourcePaths, targetDir) => api.copyFiles(sourcePaths, targetDir),
-    moveFiles: (sourcePaths, targetDir) => api.moveFiles(sourcePaths, targetDir),
-    getFileInfo: (filePath) => api.getFileInfo(filePath),
-    readImageAsBase64: (imagePath) => api.readImageAsBase64(imagePath),
-    openPath: (filePath) => api.openPath(filePath),
-    getApplicationIcon: (appPath) => api.getApplicationIcon(appPath),
-    getThumbnailUrl: (filePath) => api.getThumbnailUrl(filePath),
-    copyFilesToClipboard: (filePaths) => api.copyFilesToClipboard(filePaths),
-    getClipboardFiles: () => api.getClipboardFiles(),
-    pasteFiles: (targetDir, sourcePaths) => api.pasteFiles(targetDir, sourcePaths),
-    searchFiles: (searchPath, pattern, maxDepth) => api.searchFiles(searchPath, pattern, maxDepth),
-    searchFilesStream: (searchPath, pattern, searchId) => api.searchFilesStream(searchPath, pattern, searchId),
-    onSearchResults: (callback) => api.onSearchResults(callback),
-    compressFiles: (sources, options) => api.compressFiles(sources, options),
-    extractArchive: (archivePath, options) => api.extractArchive(archivePath, options),
-    isArchiveFile: (filePath) => api.isArchiveFile(filePath),
-    onCompressProgress: (callback) => api.onCompressProgress(callback),
-    onExtractProgress: (callback) => api.onExtractProgress(callback),
-    watchDirectory: (dirPath, watchId) => api.watchDirectory(dirPath, watchId),
-    unwatchDirectory: (watchId) => api.unwatchDirectory(watchId),
-    onWatchEvent: (callback) => api.onWatchEvent(callback),
-    showFileInfo: (filePath) => api.showFileInfo(filePath),
-    openInTerminal: (dirPath) => api.openInTerminal(dirPath),
-    openInEditor: (targetPath) => api.openInEditor(targetPath),
-    openInNewWindow: (folderPath) => api.openInNewWindow(folderPath),
-    requestWindowFocus: () => api.requestWindowFocus(),
-    // 媒体服务
-    mediaNeedsTranscode: (filePath) => api.mediaNeedsTranscode(filePath),
-    mediaGetPlayableUrl: (filePath) => api.mediaGetPlayableUrl(filePath),
-    mediaGetMetadata: (filePath) => api.mediaGetMetadata(filePath),
-    onMediaTranscodeProgress: (callback) => api.onMediaTranscodeProgress(callback),
-    mediaCleanupFile: (filePath) => api.mediaCleanupFile(filePath),
-    // 媒体预览窗口
-    openMediaPreviewWindow: (filePath, mediaType) => api.openMediaPreviewWindow(filePath, mediaType),
-    closeMediaPreviewWindow: (filePath) => api.closeMediaPreviewWindow(filePath)
-  };
+  const typedApi = api;
+  return typedApi;
 }

package/dist/renderer/index.d.cts

@@ -1,193 +1,11 @@
-import { FileItem, OperationResult, FileInfo, CompressFormat, CompressLevel } from '@huyooo/file-explorer-core';
-export { CompressFormat, CompressLevel, FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-explorer-core';
+import { FileItem, OperationResult, FileInfo, CompressOptions, CompressResult, ExtractOptions, CompressProgress, WatchEvent, TranscodeInfo, MediaMetadata, TranscodeProgress } from '@huyooo/file-explorer-core';
 
 /**
  * File Explorer Electron Bridge - Renderer Process
  *
- * 提供渲染进程使用的适配器
+ * 提供渲染进程使用的 client（仅保留 runtime 入口）
  */
 
-/** 压缩选项 */
-interface CompressOptions {
-    format: CompressFormat;
-    level?: CompressLevel;
-    outputName: string;
-    outputDir: string;
-    deleteSource?: boolean;
-}
-/** 解压选项 */
-interface ExtractOptions {
-    targetDir: string;
-    deleteArchive?: boolean;
-}
-/** 压缩进度 */
-interface CompressProgress {
-    currentFile: string;
-    processedCount: number;
-    totalCount: number;
-    percent: number;
-}
-/** 压缩结果 */
-interface CompressResult {
-    success: boolean;
-    outputPath?: string;
-    error?: string;
-}
-/** 文件变化事件类型 */
-type WatchEventType = 'add' | 'change' | 'remove' | 'rename';
-/** 文件变化事件 */
-interface WatchEvent {
-    type: WatchEventType;
-    path: string;
-    filename: string;
-}
-/** 媒体转码信息 */
-interface TranscodeInfo {
-    type: 'video' | 'audio';
-    needsTranscode: boolean;
-    method: 'direct' | 'remux' | 'transcode';
-    estimatedTime?: number;
-    targetFormat?: string;
-}
-/** 媒体转码进度 */
-interface MediaTranscodeProgress {
-    percent: number;
-    time?: number;
-    duration?: number;
-    speed?: string;
-}
-/** 媒体元数据 */
-interface MediaMetadata {
-    filePath: string;
-    type: 'video' | 'audio';
-    duration: number;
-    title?: string;
-    artist?: string;
-    album?: string;
-}
-/**
- * 文件操作适配器接口
- */
-interface FileExplorerAdapter {
-    /** 读取目录 */
-    readDirectory(dirPath: string): Promise<FileItem[]>;
-    /** 读取系统路径目录 */
-    readSystemPath(pathId: string): Promise<FileItem[]>;
-    /** 获取系统路径 */
-    getSystemPath(pathId: string): Promise<string | null>;
-    /** 读取文件内容 */
-    readFileContent(filePath: string): Promise<string>;
-    /** 写入文件内容 */
-    writeFileContent(filePath: string, content: string): Promise<OperationResult>;
-    /** 创建文件夹 */
-    createFolder(parentDir: string, folderName: string): Promise<OperationResult<{
-        finalPath: string;
-    }>>;
-    /** 创建文件 */
-    createFile(parentDir: string, fileName: string, content?: string): Promise<OperationResult<{
-        finalPath: string;
-    }>>;
-    /** 删除文件 */
-    deleteFiles(paths: string[]): Promise<OperationResult>;
-    /** 重命名文件 */
-    renameFile(oldPath: string, newPath: string): Promise<OperationResult>;
-    /** 复制文件 */
-    copyFiles(sourcePaths: string[], targetDir: string): Promise<OperationResult<{
-        copiedPaths: string[];
-    }>>;
-    /** 移动文件 */
-    moveFiles(sourcePaths: string[], targetDir: string): Promise<OperationResult<{
-        movedPaths: string[];
-    }>>;
-    /** 获取文件信息 */
-    getFileInfo(filePath: string): Promise<OperationResult<FileInfo>>;
-    /** 读取图片为 Base64 */
-    readImageAsBase64(imagePath: string): Promise<{
-        success: boolean;
-        base64?: string;
-        mimeType?: string;
-        error?: string;
-    }>;
-    /** 使用系统默认应用打开 */
-    openPath(filePath: string): Promise<OperationResult>;
-    /** 获取应用程序图标 */
-    getApplicationIcon(appPath: string): Promise<string | null>;
-    /** 获取缩略图 URL */
-    getThumbnailUrl(filePath: string): Promise<string | null>;
-    /** 复制文件到剪贴板 */
-    copyFilesToClipboard(filePaths: string[]): Promise<OperationResult>;
-    /** 从剪贴板获取文件 */
-    getClipboardFiles(): Promise<OperationResult<{
-        files: string[];
-    }>>;
-    /** 粘贴文件 */
-    pasteFiles(targetDir: string, sourcePaths: string[]): Promise<OperationResult<{
-        pastedPaths: string[];
-    }>>;
-    /** 搜索文件 */
-    searchFiles(searchPath: string, pattern: string, maxDepth?: number): Promise<OperationResult<{
-        items: FileItem[];
-        total: number;
-    }>>;
-    /** 流式搜索文件 */
-    searchFilesStream(searchPath: string, pattern: string, searchId: string): Promise<OperationResult>;
-    /** 监听搜索结果 */
-    onSearchResults(callback: (data: {
-        searchId: string;
-        items: FileItem[];
-        done: boolean;
-    }) => void): () => void;
-    /** 压缩文件 */
-    compressFiles(sources: string[], options: CompressOptions): Promise<CompressResult>;
-    /** 解压文件 */
-    extractArchive(archivePath: string, options: ExtractOptions): Promise<CompressResult>;
-    /** 判断是否为压缩文件 */
-    isArchiveFile(filePath: string): Promise<boolean>;
-    /** 监听压缩进度 */
-    onCompressProgress(callback: (data: CompressProgress) => void): () => void;
-    /** 监听解压进度 */
-    onExtractProgress(callback: (data: CompressProgress) => void): () => void;
-    /** 监听目录变化 */
-    watchDirectory(dirPath: string, watchId: string): Promise<OperationResult>;
-    /** 停止监听目录 */
-    unwatchDirectory(watchId: string): Promise<OperationResult>;
-    /** 监听文件变化事件 */
-    onWatchEvent(callback: (data: {
-        watchId: string;
-        event: WatchEvent;
-    }) => void): () => void;
-    /** 显示文件/文件夹的系统属性窗口 */
-    showFileInfo(filePath: string): Promise<OperationResult>;
-    /** 在终端中打开目录 */
-    openInTerminal(dirPath: string): Promise<OperationResult>;
-    /** 通过 Cursor 打开 */
-    openInEditor(targetPath: string): Promise<OperationResult>;
-    /** 在新窗口中打开文件夹（使用系统文件管理器） */
-    openInNewWindow(folderPath: string): Promise<OperationResult>;
-    /** 请求窗口聚焦（用于右键打开菜单前激活窗口） */
-    requestWindowFocus(): void;
-    /** 检测媒体文件是否需要转码 */
-    mediaNeedsTranscode(filePath: string): Promise<OperationResult<TranscodeInfo>>;
-    /** 获取可播放的媒体 URL（自动转码） */
-    mediaGetPlayableUrl(filePath: string): Promise<{
-        success: boolean;
-        url?: string;
-        error?: string;
-    }>;
-    /** 获取媒体元数据 */
-    mediaGetMetadata(filePath: string): Promise<OperationResult<MediaMetadata>>;
-    /** 监听转码进度 */
-    onMediaTranscodeProgress(callback: (data: {
-        filePath: string;
-        progress: MediaTranscodeProgress;
-    }) => void): () => void;
-    /** 清理指定文件的转码缓存 */
-    mediaCleanupFile(filePath: string): Promise<OperationResult>;
-    /** 打开媒体预览窗口（原生窗口） */
-    openMediaPreviewWindow(filePath: string, mediaType: 'image' | 'video' | 'audio'): Promise<OperationResult>;
-    /** 关闭媒体预览窗口 */
-    closeMediaPreviewWindow(filePath: string): Promise<OperationResult>;
-}
 /**
  * Window 扩展类型
  */
@@ -265,7 +83,7 @@ declare global {
             mediaGetMetadata: (filePath: string) => Promise<OperationResult<MediaMetadata>>;
             onMediaTranscodeProgress: (callback: (data: {
                 filePath: string;
-                progress: MediaTranscodeProgress;
+                progress: TranscodeProgress;
             }) => void) => () => void;
             mediaCleanupFile: (filePath: string) => Promise<OperationResult>;
             openMediaPreviewWindow: (filePath: string, mediaType: 'image' | 'video' | 'audio') => Promise<OperationResult>;
@@ -274,15 +92,92 @@ declare global {
     }
 }
 /**
- * 创建 Electron 适配器
+ * 创建 File Explorer Client（渲染进程唯一入口）
  *
  * 在渲染进程中使用：
  * ```ts
- * import { createElectronAdapter } from '@aspect/file-explorer-bridge-electron/renderer';
- * const adapter = createElectronAdapter();
- * const files = await adapter.readDirectory('/path/to/dir');
+ * import { createFileExplorerClient } from '@huyooo/file-explorer-bridge-electron/renderer';
+ * const client = createFileExplorerClient();
+ * const files = await client.readDirectory('/path/to/dir');
  * ```
  */
-declare function createElectronAdapter(): FileExplorerAdapter;
+declare function createFileExplorerClient(apiName?: string): {
+    readDirectory: (dirPath: string) => Promise<FileItem[]>;
+    readSystemPath: (pathId: string) => Promise<FileItem[]>;
+    getSystemPath: (pathId: string) => Promise<string | null>;
+    readFileContent: (filePath: string) => Promise<string>;
+    writeFileContent: (filePath: string, content: string) => Promise<OperationResult>;
+    createFolder: (parentDir: string, folderName: string) => Promise<OperationResult<{
+        finalPath: string;
+    }>>;
+    createFile: (parentDir: string, fileName: string, content?: string) => Promise<OperationResult<{
+        finalPath: string;
+    }>>;
+    deleteFiles: (paths: string[]) => Promise<OperationResult>;
+    renameFile: (oldPath: string, newPath: string) => Promise<OperationResult>;
+    copyFiles: (sourcePaths: string[], targetDir: string) => Promise<OperationResult<{
+        copiedPaths: string[];
+    }>>;
+    moveFiles: (sourcePaths: string[], targetDir: string) => Promise<OperationResult<{
+        movedPaths: string[];
+    }>>;
+    getFileInfo: (filePath: string) => Promise<OperationResult<FileInfo>>;
+    readImageAsBase64: (imagePath: string) => Promise<{
+        success: boolean;
+        base64?: string;
+        mimeType?: string;
+        error?: string;
+    }>;
+    openPath: (filePath: string) => Promise<OperationResult>;
+    getApplicationIcon: (appPath: string) => Promise<string | null>;
+    getThumbnailUrl: (filePath: string) => Promise<string | null>;
+    copyFilesToClipboard: (filePaths: string[]) => Promise<OperationResult>;
+    getClipboardFiles: () => Promise<OperationResult<{
+        files: string[];
+    }>>;
+    pasteFiles: (targetDir: string, sourcePaths: string[]) => Promise<OperationResult<{
+        pastedPaths: string[];
+    }>>;
+    searchFiles: (searchPath: string, pattern: string, maxDepth?: number) => Promise<OperationResult<{
+        items: FileItem[];
+        total: number;
+    }>>;
+    searchFilesStream: (searchPath: string, pattern: string, searchId: string) => Promise<OperationResult>;
+    onSearchResults: (callback: (data: {
+        searchId: string;
+        items: FileItem[];
+        done: boolean;
+    }) => void) => () => void;
+    compressFiles: (sources: string[], options: CompressOptions) => Promise<CompressResult>;
+    extractArchive: (archivePath: string, options: ExtractOptions) => Promise<CompressResult>;
+    isArchiveFile: (filePath: string) => Promise<boolean>;
+    onCompressProgress: (callback: (data: CompressProgress) => void) => () => void;
+    onExtractProgress: (callback: (data: CompressProgress) => void) => () => void;
+    watchDirectory: (dirPath: string, watchId: string) => Promise<OperationResult>;
+    unwatchDirectory: (watchId: string) => Promise<OperationResult>;
+    onWatchEvent: (callback: (data: {
+        watchId: string;
+        event: WatchEvent;
+    }) => void) => () => void;
+    showFileInfo: (filePath: string) => Promise<OperationResult>;
+    openInTerminal: (dirPath: string) => Promise<OperationResult>;
+    openInEditor: (targetPath: string) => Promise<OperationResult>;
+    openInNewWindow: (folderPath: string) => Promise<OperationResult>;
+    requestWindowFocus: () => void;
+    mediaNeedsTranscode: (filePath: string) => Promise<OperationResult<TranscodeInfo>>;
+    mediaGetPlayableUrl: (filePath: string) => Promise<{
+        success: boolean;
+        url?: string;
+        error?: string;
+    }>;
+    mediaGetMetadata: (filePath: string) => Promise<OperationResult<MediaMetadata>>;
+    onMediaTranscodeProgress: (callback: (data: {
+        filePath: string;
+        progress: TranscodeProgress;
+    }) => void) => () => void;
+    mediaCleanupFile: (filePath: string) => Promise<OperationResult>;
+    openMediaPreviewWindow: (filePath: string, mediaType: "image" | "video" | "audio") => Promise<OperationResult>;
+    closeMediaPreviewWindow: (filePath: string) => Promise<OperationResult>;
+};
 
-export { type CompressOptions, type CompressProgress, type CompressResult, type ExtractOptions, type FileExplorerAdapter, type MediaMetadata, type MediaTranscodeProgress, type TranscodeInfo, type WatchEvent, type WatchEventType, createElectronAdapter };
+export { createFileExplorerClient };

package/dist/renderer/index.d.ts

@@ -1,193 +1,11 @@
-import { FileItem, OperationResult, FileInfo, CompressFormat, CompressLevel } from '@huyooo/file-explorer-core';
-export { CompressFormat, CompressLevel, FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-explorer-core';
+import { FileItem, OperationResult, FileInfo, CompressOptions, CompressResult, ExtractOptions, CompressProgress, WatchEvent, TranscodeInfo, MediaMetadata, TranscodeProgress } from '@huyooo/file-explorer-core';
 
 /**
  * File Explorer Electron Bridge - Renderer Process
  *
- * 提供渲染进程使用的适配器
+ * 提供渲染进程使用的 client（仅保留 runtime 入口）
  */
 
-/** 压缩选项 */
-interface CompressOptions {
-    format: CompressFormat;
-    level?: CompressLevel;
-    outputName: string;
-    outputDir: string;
-    deleteSource?: boolean;
-}
-/** 解压选项 */
-interface ExtractOptions {
-    targetDir: string;
-    deleteArchive?: boolean;
-}
-/** 压缩进度 */
-interface CompressProgress {
-    currentFile: string;
-    processedCount: number;
-    totalCount: number;
-    percent: number;
-}
-/** 压缩结果 */
-interface CompressResult {
-    success: boolean;
-    outputPath?: string;
-    error?: string;
-}
-/** 文件变化事件类型 */
-type WatchEventType = 'add' | 'change' | 'remove' | 'rename';
-/** 文件变化事件 */
-interface WatchEvent {
-    type: WatchEventType;
-    path: string;
-    filename: string;
-}
-/** 媒体转码信息 */
-interface TranscodeInfo {
-    type: 'video' | 'audio';
-    needsTranscode: boolean;
-    method: 'direct' | 'remux' | 'transcode';
-    estimatedTime?: number;
-    targetFormat?: string;
-}
-/** 媒体转码进度 */
-interface MediaTranscodeProgress {
-    percent: number;
-    time?: number;
-    duration?: number;
-    speed?: string;
-}
-/** 媒体元数据 */
-interface MediaMetadata {
-    filePath: string;
-    type: 'video' | 'audio';
-    duration: number;
-    title?: string;
-    artist?: string;
-    album?: string;
-}
-/**
- * 文件操作适配器接口
- */
-interface FileExplorerAdapter {
-    /** 读取目录 */
-    readDirectory(dirPath: string): Promise<FileItem[]>;
-    /** 读取系统路径目录 */
-    readSystemPath(pathId: string): Promise<FileItem[]>;
-    /** 获取系统路径 */
-    getSystemPath(pathId: string): Promise<string | null>;
-    /** 读取文件内容 */
-    readFileContent(filePath: string): Promise<string>;
-    /** 写入文件内容 */
-    writeFileContent(filePath: string, content: string): Promise<OperationResult>;
-    /** 创建文件夹 */
-    createFolder(parentDir: string, folderName: string): Promise<OperationResult<{
-        finalPath: string;
-    }>>;
-    /** 创建文件 */
-    createFile(parentDir: string, fileName: string, content?: string): Promise<OperationResult<{
-        finalPath: string;
-    }>>;
-    /** 删除文件 */
-    deleteFiles(paths: string[]): Promise<OperationResult>;
-    /** 重命名文件 */
-    renameFile(oldPath: string, newPath: string): Promise<OperationResult>;
-    /** 复制文件 */
-    copyFiles(sourcePaths: string[], targetDir: string): Promise<OperationResult<{
-        copiedPaths: string[];
-    }>>;
-    /** 移动文件 */
-    moveFiles(sourcePaths: string[], targetDir: string): Promise<OperationResult<{
-        movedPaths: string[];
-    }>>;
-    /** 获取文件信息 */
-    getFileInfo(filePath: string): Promise<OperationResult<FileInfo>>;
-    /** 读取图片为 Base64 */
-    readImageAsBase64(imagePath: string): Promise<{
-        success: boolean;
-        base64?: string;
-        mimeType?: string;
-        error?: string;
-    }>;
-    /** 使用系统默认应用打开 */
-    openPath(filePath: string): Promise<OperationResult>;
-    /** 获取应用程序图标 */
-    getApplicationIcon(appPath: string): Promise<string | null>;
-    /** 获取缩略图 URL */
-    getThumbnailUrl(filePath: string): Promise<string | null>;
-    /** 复制文件到剪贴板 */
-    copyFilesToClipboard(filePaths: string[]): Promise<OperationResult>;
-    /** 从剪贴板获取文件 */
-    getClipboardFiles(): Promise<OperationResult<{
-        files: string[];
-    }>>;
-    /** 粘贴文件 */
-    pasteFiles(targetDir: string, sourcePaths: string[]): Promise<OperationResult<{
-        pastedPaths: string[];
-    }>>;
-    /** 搜索文件 */
-    searchFiles(searchPath: string, pattern: string, maxDepth?: number): Promise<OperationResult<{
-        items: FileItem[];
-        total: number;
-    }>>;
-    /** 流式搜索文件 */
-    searchFilesStream(searchPath: string, pattern: string, searchId: string): Promise<OperationResult>;
-    /** 监听搜索结果 */
-    onSearchResults(callback: (data: {
-        searchId: string;
-        items: FileItem[];
-        done: boolean;
-    }) => void): () => void;
-    /** 压缩文件 */
-    compressFiles(sources: string[], options: CompressOptions): Promise<CompressResult>;
-    /** 解压文件 */
-    extractArchive(archivePath: string, options: ExtractOptions): Promise<CompressResult>;
-    /** 判断是否为压缩文件 */
-    isArchiveFile(filePath: string): Promise<boolean>;
-    /** 监听压缩进度 */
-    onCompressProgress(callback: (data: CompressProgress) => void): () => void;
-    /** 监听解压进度 */
-    onExtractProgress(callback: (data: CompressProgress) => void): () => void;
-    /** 监听目录变化 */
-    watchDirectory(dirPath: string, watchId: string): Promise<OperationResult>;
-    /** 停止监听目录 */
-    unwatchDirectory(watchId: string): Promise<OperationResult>;
-    /** 监听文件变化事件 */
-    onWatchEvent(callback: (data: {
-        watchId: string;
-        event: WatchEvent;
-    }) => void): () => void;
-    /** 显示文件/文件夹的系统属性窗口 */
-    showFileInfo(filePath: string): Promise<OperationResult>;
-    /** 在终端中打开目录 */
-    openInTerminal(dirPath: string): Promise<OperationResult>;
-    /** 通过 Cursor 打开 */
-    openInEditor(targetPath: string): Promise<OperationResult>;
-    /** 在新窗口中打开文件夹（使用系统文件管理器） */
-    openInNewWindow(folderPath: string): Promise<OperationResult>;
-    /** 请求窗口聚焦（用于右键打开菜单前激活窗口） */
-    requestWindowFocus(): void;
-    /** 检测媒体文件是否需要转码 */
-    mediaNeedsTranscode(filePath: string): Promise<OperationResult<TranscodeInfo>>;
-    /** 获取可播放的媒体 URL（自动转码） */
-    mediaGetPlayableUrl(filePath: string): Promise<{
-        success: boolean;
-        url?: string;
-        error?: string;
-    }>;
-    /** 获取媒体元数据 */
-    mediaGetMetadata(filePath: string): Promise<OperationResult<MediaMetadata>>;
-    /** 监听转码进度 */
-    onMediaTranscodeProgress(callback: (data: {
-        filePath: string;
-        progress: MediaTranscodeProgress;
-    }) => void): () => void;
-    /** 清理指定文件的转码缓存 */
-    mediaCleanupFile(filePath: string): Promise<OperationResult>;
-    /** 打开媒体预览窗口（原生窗口） */
-    openMediaPreviewWindow(filePath: string, mediaType: 'image' | 'video' | 'audio'): Promise<OperationResult>;
-    /** 关闭媒体预览窗口 */
-    closeMediaPreviewWindow(filePath: string): Promise<OperationResult>;
-}
 /**
  * Window 扩展类型
  */
@@ -265,7 +83,7 @@ declare global {
             mediaGetMetadata: (filePath: string) => Promise<OperationResult<MediaMetadata>>;
             onMediaTranscodeProgress: (callback: (data: {
                 filePath: string;
-                progress: MediaTranscodeProgress;
+                progress: TranscodeProgress;
             }) => void) => () => void;
             mediaCleanupFile: (filePath: string) => Promise<OperationResult>;
             openMediaPreviewWindow: (filePath: string, mediaType: 'image' | 'video' | 'audio') => Promise<OperationResult>;
@@ -274,15 +92,92 @@ declare global {
     }
 }
 /**
- * 创建 Electron 适配器
+ * 创建 File Explorer Client（渲染进程唯一入口）
  *
  * 在渲染进程中使用：
  * ```ts
- * import { createElectronAdapter } from '@aspect/file-explorer-bridge-electron/renderer';
- * const adapter = createElectronAdapter();
- * const files = await adapter.readDirectory('/path/to/dir');
+ * import { createFileExplorerClient } from '@huyooo/file-explorer-bridge-electron/renderer';
+ * const client = createFileExplorerClient();
+ * const files = await client.readDirectory('/path/to/dir');
  * ```
  */
-declare function createElectronAdapter(): FileExplorerAdapter;
+declare function createFileExplorerClient(apiName?: string): {
+    readDirectory: (dirPath: string) => Promise<FileItem[]>;
+    readSystemPath: (pathId: string) => Promise<FileItem[]>;
+    getSystemPath: (pathId: string) => Promise<string | null>;
+    readFileContent: (filePath: string) => Promise<string>;
+    writeFileContent: (filePath: string, content: string) => Promise<OperationResult>;
+    createFolder: (parentDir: string, folderName: string) => Promise<OperationResult<{
+        finalPath: string;
+    }>>;
+    createFile: (parentDir: string, fileName: string, content?: string) => Promise<OperationResult<{
+        finalPath: string;
+    }>>;
+    deleteFiles: (paths: string[]) => Promise<OperationResult>;
+    renameFile: (oldPath: string, newPath: string) => Promise<OperationResult>;
+    copyFiles: (sourcePaths: string[], targetDir: string) => Promise<OperationResult<{
+        copiedPaths: string[];
+    }>>;
+    moveFiles: (sourcePaths: string[], targetDir: string) => Promise<OperationResult<{
+        movedPaths: string[];
+    }>>;
+    getFileInfo: (filePath: string) => Promise<OperationResult<FileInfo>>;
+    readImageAsBase64: (imagePath: string) => Promise<{
+        success: boolean;
+        base64?: string;
+        mimeType?: string;
+        error?: string;
+    }>;
+    openPath: (filePath: string) => Promise<OperationResult>;
+    getApplicationIcon: (appPath: string) => Promise<string | null>;
+    getThumbnailUrl: (filePath: string) => Promise<string | null>;
+    copyFilesToClipboard: (filePaths: string[]) => Promise<OperationResult>;
+    getClipboardFiles: () => Promise<OperationResult<{
+        files: string[];
+    }>>;
+    pasteFiles: (targetDir: string, sourcePaths: string[]) => Promise<OperationResult<{
+        pastedPaths: string[];
+    }>>;
+    searchFiles: (searchPath: string, pattern: string, maxDepth?: number) => Promise<OperationResult<{
+        items: FileItem[];
+        total: number;
+    }>>;
+    searchFilesStream: (searchPath: string, pattern: string, searchId: string) => Promise<OperationResult>;
+    onSearchResults: (callback: (data: {
+        searchId: string;
+        items: FileItem[];
+        done: boolean;
+    }) => void) => () => void;
+    compressFiles: (sources: string[], options: CompressOptions) => Promise<CompressResult>;
+    extractArchive: (archivePath: string, options: ExtractOptions) => Promise<CompressResult>;
+    isArchiveFile: (filePath: string) => Promise<boolean>;
+    onCompressProgress: (callback: (data: CompressProgress) => void) => () => void;
+    onExtractProgress: (callback: (data: CompressProgress) => void) => () => void;
+    watchDirectory: (dirPath: string, watchId: string) => Promise<OperationResult>;
+    unwatchDirectory: (watchId: string) => Promise<OperationResult>;
+    onWatchEvent: (callback: (data: {
+        watchId: string;
+        event: WatchEvent;
+    }) => void) => () => void;
+    showFileInfo: (filePath: string) => Promise<OperationResult>;
+    openInTerminal: (dirPath: string) => Promise<OperationResult>;
+    openInEditor: (targetPath: string) => Promise<OperationResult>;
+    openInNewWindow: (folderPath: string) => Promise<OperationResult>;
+    requestWindowFocus: () => void;
+    mediaNeedsTranscode: (filePath: string) => Promise<OperationResult<TranscodeInfo>>;
+    mediaGetPlayableUrl: (filePath: string) => Promise<{
+        success: boolean;
+        url?: string;
+        error?: string;
+    }>;
+    mediaGetMetadata: (filePath: string) => Promise<OperationResult<MediaMetadata>>;
+    onMediaTranscodeProgress: (callback: (data: {
+        filePath: string;
+        progress: TranscodeProgress;
+    }) => void) => () => void;
+    mediaCleanupFile: (filePath: string) => Promise<OperationResult>;
+    openMediaPreviewWindow: (filePath: string, mediaType: "image" | "video" | "audio") => Promise<OperationResult>;
+    closeMediaPreviewWindow: (filePath: string) => Promise<OperationResult>;
+};
 
-export { type CompressOptions, type CompressProgress, type CompressResult, type ExtractOptions, type FileExplorerAdapter, type MediaMetadata, type MediaTranscodeProgress, type TranscodeInfo, type WatchEvent, type WatchEventType, createElectronAdapter };
+export { createFileExplorerClient };

package/dist/renderer/index.js

@@ -1,58 +1,14 @@
 // src/renderer/index.ts
-function createElectronAdapter() {
-  const api = window.fileExplorerAPI;
+function createFileExplorerClient(apiName = "fileExplorerAPI") {
+  const api = apiName === "fileExplorerAPI" ? window.fileExplorerAPI : window[apiName];
   if (!api) {
     throw new Error(
-      "window.fileExplorerAPI not found. Make sure to call exposeFileExplorerAPI() in your preload script."
+      `window.${apiName} not found. Make sure to call exposeFileExplorerAPI({ apiName }) in your preload script.`
     );
   }
-  return {
-    readDirectory: (dirPath) => api.readDirectory(dirPath),
-    readSystemPath: (pathId) => api.readSystemPath(pathId),
-    getSystemPath: (pathId) => api.getSystemPath(pathId),
-    readFileContent: (filePath) => api.readFileContent(filePath),
-    writeFileContent: (filePath, content) => api.writeFileContent(filePath, content),
-    createFolder: (parentDir, folderName) => api.createFolder(parentDir, folderName),
-    createFile: (parentDir, fileName, content) => api.createFile(parentDir, fileName, content),
-    deleteFiles: (paths) => api.deleteFiles(paths),
-    renameFile: (oldPath, newPath) => api.renameFile(oldPath, newPath),
-    copyFiles: (sourcePaths, targetDir) => api.copyFiles(sourcePaths, targetDir),
-    moveFiles: (sourcePaths, targetDir) => api.moveFiles(sourcePaths, targetDir),
-    getFileInfo: (filePath) => api.getFileInfo(filePath),
-    readImageAsBase64: (imagePath) => api.readImageAsBase64(imagePath),
-    openPath: (filePath) => api.openPath(filePath),
-    getApplicationIcon: (appPath) => api.getApplicationIcon(appPath),
-    getThumbnailUrl: (filePath) => api.getThumbnailUrl(filePath),
-    copyFilesToClipboard: (filePaths) => api.copyFilesToClipboard(filePaths),
-    getClipboardFiles: () => api.getClipboardFiles(),
-    pasteFiles: (targetDir, sourcePaths) => api.pasteFiles(targetDir, sourcePaths),
-    searchFiles: (searchPath, pattern, maxDepth) => api.searchFiles(searchPath, pattern, maxDepth),
-    searchFilesStream: (searchPath, pattern, searchId) => api.searchFilesStream(searchPath, pattern, searchId),
-    onSearchResults: (callback) => api.onSearchResults(callback),
-    compressFiles: (sources, options) => api.compressFiles(sources, options),
-    extractArchive: (archivePath, options) => api.extractArchive(archivePath, options),
-    isArchiveFile: (filePath) => api.isArchiveFile(filePath),
-    onCompressProgress: (callback) => api.onCompressProgress(callback),
-    onExtractProgress: (callback) => api.onExtractProgress(callback),
-    watchDirectory: (dirPath, watchId) => api.watchDirectory(dirPath, watchId),
-    unwatchDirectory: (watchId) => api.unwatchDirectory(watchId),
-    onWatchEvent: (callback) => api.onWatchEvent(callback),
-    showFileInfo: (filePath) => api.showFileInfo(filePath),
-    openInTerminal: (dirPath) => api.openInTerminal(dirPath),
-    openInEditor: (targetPath) => api.openInEditor(targetPath),
-    openInNewWindow: (folderPath) => api.openInNewWindow(folderPath),
-    requestWindowFocus: () => api.requestWindowFocus(),
-    // 媒体服务
-    mediaNeedsTranscode: (filePath) => api.mediaNeedsTranscode(filePath),
-    mediaGetPlayableUrl: (filePath) => api.mediaGetPlayableUrl(filePath),
-    mediaGetMetadata: (filePath) => api.mediaGetMetadata(filePath),
-    onMediaTranscodeProgress: (callback) => api.onMediaTranscodeProgress(callback),
-    mediaCleanupFile: (filePath) => api.mediaCleanupFile(filePath),
-    // 媒体预览窗口
-    openMediaPreviewWindow: (filePath, mediaType) => api.openMediaPreviewWindow(filePath, mediaType),
-    closeMediaPreviewWindow: (filePath) => api.closeMediaPreviewWindow(filePath)
-  };
+  const typedApi = api;
+  return typedApi;
 }
 export {
-  createElectronAdapter
+  createFileExplorerClient
 };

package/package.json

@@ -1,29 +1,26 @@
 {
   "name": "@huyooo/file-explorer-bridge-electron",
-  "version": "0.4.5",
+  "version": "0.4.10",
   "description": "File Explorer Electron Bridge - IPC integration for Electron apps",
   "type": "module",
-  "main": "./dist/main/index.cjs",
+  "main": "./dist/main/index.js",
   "module": "./dist/main/index.js",
   "types": "./dist/main/index.d.ts",
   "exports": {
     "./main": {
       "types": "./dist/main/index.d.ts",
       "development": "./src/main/index.ts",
-      "import": "./dist/main/index.js",
-      "require": "./dist/main/index.cjs"
+      "import": "./dist/main/index.js"
     },
     "./preload": {
       "types": "./dist/preload/index.d.ts",
       "development": "./src/preload/index.ts",
-      "import": "./dist/preload/index.js",
-      "require": "./dist/preload/index.cjs"
+      "import": "./dist/preload/index.js"
     },
     "./renderer": {
       "types": "./dist/renderer/index.d.ts",
       "development": "./src/renderer/index.ts",
-      "import": "./dist/renderer/index.js",
-      "require": "./dist/renderer/index.cjs"
+      "import": "./dist/renderer/index.js"
     }
   },
   "files": [
@@ -36,8 +33,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@huyooo/file-explorer-core": "^0.4.5",
-    "@huyooo/file-explorer-preview": "^0.4.5"
+    "@huyooo/file-explorer-core": "^0.4.10",
+    "@huyooo/file-explorer-preview": "^0.4.10"
   },
   "peerDependencies": {
     "electron": ">=20.0.0"