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

package/dist/renderer/index.d.cts

@@ -1,5 +1,5 @@
-import { FileItem, OperationResult, FileInfo } from '@huyooo/file-explorer-core';
-export { FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-explorer-core';
+import { FileItem, OperationResult, FileInfo, CompressFormat, CompressLevel } from '@huyooo/file-explorer-core';
+export { CompressFormat, CompressLevel, FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-explorer-core';
 
 /**
  * File Explorer Electron Bridge - Renderer Process
@@ -7,6 +7,64 @@ export { FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-
  * 提供渲染进程使用的适配器
  */
 
+/** 压缩选项 */
+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;
+}
 /**
  * 文件操作适配器接口
  */
@@ -79,6 +137,56 @@ interface FileExplorerAdapter {
         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 扩展类型
@@ -132,6 +240,36 @@ declare global {
                 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: MediaTranscodeProgress;
+            }) => void) => () => void;
+            mediaCleanupFile: (filePath: string) => Promise<OperationResult>;
+            openMediaPreviewWindow: (filePath: string, mediaType: 'image' | 'video' | 'audio') => Promise<OperationResult>;
+            closeMediaPreviewWindow: (filePath: string) => Promise<OperationResult>;
         };
     }
 }
@@ -147,4 +285,4 @@ declare global {
  */
 declare function createElectronAdapter(): FileExplorerAdapter;
 
-export { type FileExplorerAdapter, createElectronAdapter };
+export { type CompressOptions, type CompressProgress, type CompressResult, type ExtractOptions, type FileExplorerAdapter, type MediaMetadata, type MediaTranscodeProgress, type TranscodeInfo, type WatchEvent, type WatchEventType, createElectronAdapter };

package/dist/renderer/index.d.ts

@@ -1,5 +1,5 @@
-import { FileItem, OperationResult, FileInfo } from '@huyooo/file-explorer-core';
-export { FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-explorer-core';
+import { FileItem, OperationResult, FileInfo, CompressFormat, CompressLevel } from '@huyooo/file-explorer-core';
+export { CompressFormat, CompressLevel, FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-explorer-core';
 
 /**
  * File Explorer Electron Bridge - Renderer Process
@@ -7,6 +7,64 @@ export { FileInfo, FileItem, OperationResult, SystemPathId } from '@huyooo/file-
  * 提供渲染进程使用的适配器
  */
 
+/** 压缩选项 */
+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;
+}
 /**
  * 文件操作适配器接口
  */
@@ -79,6 +137,56 @@ interface FileExplorerAdapter {
         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 扩展类型
@@ -132,6 +240,36 @@ declare global {
                 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: MediaTranscodeProgress;
+            }) => void) => () => void;
+            mediaCleanupFile: (filePath: string) => Promise<OperationResult>;
+            openMediaPreviewWindow: (filePath: string, mediaType: 'image' | 'video' | 'audio') => Promise<OperationResult>;
+            closeMediaPreviewWindow: (filePath: string) => Promise<OperationResult>;
         };
     }
 }
@@ -147,4 +285,4 @@ declare global {
  */
 declare function createElectronAdapter(): FileExplorerAdapter;
 
-export { type FileExplorerAdapter, createElectronAdapter };
+export { type CompressOptions, type CompressProgress, type CompressResult, type ExtractOptions, type FileExplorerAdapter, type MediaMetadata, type MediaTranscodeProgress, type TranscodeInfo, type WatchEvent, type WatchEventType, createElectronAdapter };

package/dist/renderer/index.js

@@ -28,7 +28,29 @@ function createElectronAdapter() {
     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)
+    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)
   };
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huyooo/file-explorer-bridge-electron",
-  "version": "0.3.0",
+  "version": "0.4.3",
   "description": "File Explorer Electron Bridge - IPC integration for Electron apps",
   "type": "module",
   "main": "./dist/main/index.cjs",
@@ -36,7 +36,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@huyooo/file-explorer-core": "^0.3.0"
+    "@huyooo/file-explorer-core": "^0.4.3",
+    "@huyooo/file-explorer-preview": "^0.1.0"
   },
   "peerDependencies": {
     "electron": ">=20.0.0"