@huyooo/file-explorer-frontend-vue 0.4.2

package/dist/types/index.d.ts

@@ -0,0 +1,268 @@
+/**
+ * 文件类型（使用 const object 而非 enum，更好的 tree-shaking）
+ */
+export declare const FileType: {
+    readonly FOLDER: "folder";
+    readonly FILE: "file";
+    readonly IMAGE: "image";
+    readonly VIDEO: "video";
+    readonly MUSIC: "music";
+    readonly DOCUMENT: "document";
+    readonly CODE: "code";
+    readonly TEXT: "text";
+    readonly PDF: "pdf";
+    readonly ARCHIVE: "archive";
+    readonly APPLICATION: "application";
+    readonly UNKNOWN: "unknown";
+};
+export type FileType = typeof FileType[keyof typeof FileType];
+/**
+ * 文件系统项
+ */
+export interface FileItem {
+    /** 唯一标识（通常是完整路径） */
+    id: string;
+    name: string;
+    type: FileType;
+    size?: string;
+    dateModified?: string;
+    url?: string;
+    thumbnailUrl?: string;
+    children?: FileItem[];
+}
+/**
+ * 视图模式
+ */
+export type ViewMode = 'grid' | 'list' | 'columns';
+/**
+ * 排序配置
+ */
+export interface SortConfig {
+    field: 'name' | 'dateModified' | 'size' | 'type';
+    direction: 'asc' | 'desc';
+}
+/**
+ * 侧边栏项目
+ */
+export interface SidebarItem {
+    id: string;
+    label: string;
+    icon?: string;
+    path?: string;
+    children?: SidebarItem[];
+}
+/**
+ * 面包屑项
+ */
+export interface BreadcrumbItem {
+    id: string;
+    name: string;
+}
+/**
+ * 操作结果
+ */
+export interface OperationResult<T = void> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+/** 压缩格式 */
+export type CompressFormat = 'zip' | 'tar' | 'tgz' | 'tarbz2';
+/** 压缩级别 */
+export type CompressLevel = 'fast' | 'normal' | 'best';
+/** 压缩选项 */
+export interface CompressOptions {
+    format: CompressFormat;
+    level?: CompressLevel;
+    outputName: string;
+    outputDir: string;
+    deleteSource?: boolean;
+}
+/** 解压选项 */
+export interface ExtractOptions {
+    targetDir: string;
+    deleteArchive?: boolean;
+}
+/** 压缩进度 */
+export interface CompressProgress {
+    currentFile: string;
+    processedCount: number;
+    totalCount: number;
+    percent: number;
+}
+/** 压缩结果 */
+export interface CompressResult {
+    success: boolean;
+    outputPath?: string;
+    error?: string;
+}
+/** 进度状态 */
+export type ProgressStatus = 'pending' | 'processing' | 'success' | 'error';
+/** 进度信息（UI 使用） */
+export interface ProgressInfo {
+    type: 'compress' | 'extract';
+    status: ProgressStatus;
+    percent: number;
+    currentFile?: string;
+    processedCount?: number;
+    totalCount?: number;
+    error?: string;
+    outputPath?: string;
+}
+/**
+ * 文件操作适配器接口
+ */
+export 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[];
+    }>>;
+    /** 使用系统默认应用打开 */
+    openPath(filePath: string): Promise<OperationResult>;
+    /** 复制文件到剪贴板 */
+    copyFilesToClipboard(filePaths: string[]): Promise<OperationResult>;
+    /** 获取剪贴板文件 */
+    getClipboardFiles(): Promise<OperationResult<{
+        files: string[];
+    }>>;
+    /** 粘贴文件 */
+    pasteFiles(targetDir: string, sourcePaths: string[]): Promise<OperationResult<{
+        pastedPaths: string[];
+    }>>;
+    /** 流式搜索文件 */
+    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>;
+}
+/** 文件变化事件类型 */
+export type WatchEventType = 'add' | 'change' | 'remove' | 'rename';
+/** 文件变化事件 */
+export interface WatchEvent {
+    type: WatchEventType;
+    path: string;
+    filename: string;
+}
+/** 媒体转码方式 */
+export type TranscodeMethod = 'direct' | 'remux' | 'transcode';
+/** 媒体转码状态 */
+export type TranscodeStatus = 'idle' | 'checking' | 'transcoding' | 'ready' | 'error';
+/** 媒体转码信息 */
+export interface TranscodeInfo {
+    type: 'video' | 'audio';
+    needsTranscode: boolean;
+    method: TranscodeMethod;
+    estimatedTime?: number;
+    targetFormat?: string;
+}
+/** 媒体转码进度 */
+export interface MediaTranscodeProgress {
+    percent: number;
+    time?: number;
+    duration?: number;
+    speed?: string;
+}
+/** 媒体元数据 */
+export interface MediaMetadata {
+    filePath: string;
+    type: 'video' | 'audio';
+    duration: number;
+    title?: string;
+    artist?: string;
+    album?: string;
+}
+/**
+ * 右键菜单项
+ */
+export interface ContextMenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    shortcut?: string;
+    disabled?: boolean;
+    separator?: boolean;
+    danger?: boolean;
+    checked?: boolean;
+    action?: () => void;
+    children?: ContextMenuItem[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/fileTypeIcon.d.ts

@@ -0,0 +1,6 @@
+import { FileType } from '../types';
+/**
+ * 根据文件名获取 material-icon-theme 图标名称
+ */
+export declare function getFileTypeIcon(fileName: string, fallbackType?: FileType): string;
+//# sourceMappingURL=fileTypeIcon.d.ts.map

package/dist/utils/fileTypeIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTypeIcon.d.ts","sourceRoot":"","sources":["../../src/utils/fileTypeIcon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAyOpC;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,QAAQ,GAAG,MAAM,CAwDjF"}

package/dist/utils/folderTypeIcon.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 文件夹图标映射（基于 material-icon-theme.json）
+ *
+ * 原理：
+ * 1. KNOWN_TYPES：从 material-icon-theme.json 提取的所有 folder-{type} 类型
+ * 2. ALIASES：常见变体映射到标准名
+ * 3. 逻辑：目录名小写 → 查别名 → 查白名单 → 命中则返回 material-icon-theme:folder-{type}
+ */
+/**
+ * 根据文件夹名称获取对应的 material-icon-theme 图标名
+ * @returns 图标名 或 undefined（让上层兜底默认图标）
+ */
+export declare function getFolderTypeIcon(folderName: string): string | undefined;
+//# sourceMappingURL=folderTypeIcon.d.ts.map

package/dist/utils/folderTypeIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderTypeIcon.d.ts","sourceRoot":"","sources":["../../src/utils/folderTypeIcon.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4GH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYxE"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@huyooo/file-explorer-frontend-vue",
+  "version": "0.4.2",
+  "description": "File Explorer Frontend - Vue components for file management",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./style.css": "./dist/index.css"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "vue-tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "dependencies": {
+    "@iconify/vue": "^5.0.0",
+    "lucide-vue-next": "^0.460.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitejs/plugin-vue": "^5.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vue": "^3.4.0",
+    "vue-tsc": "^2.0.0"
+  },
+  "keywords": [
+    "file",
+    "explorer",
+    "vue",
+    "frontend"
+  ],
+  "author": "huyooo",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/components/Breadcrumb.vue

@@ -0,0 +1,111 @@
+<template>
+  <div class="file-breadcrumb">
+    <span 
+      v-for="(item, index) in items" 
+      :key="item.id"
+      class="file-breadcrumb-item"
+    >
+      <span 
+        @click="handleClick(item, index)"
+        :class="[
+          'file-breadcrumb-link',
+          index === items.length - 1 ? 'file-breadcrumb-link--current' : ''
+        ]"
+      >
+        {{ item.name }}
+      </span>
+      <Icon 
+        v-if="index < items.length - 1" 
+        icon="lucide:chevron-right" 
+        :width="14" 
+        :height="14" 
+        class="file-breadcrumb-separator" 
+      />
+    </span>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { Icon } from '@iconify/vue';
+import type { BreadcrumbItem } from '../types';
+
+// Props
+const props = defineProps<{
+  items: BreadcrumbItem[];
+}>();
+
+// Events
+const emit = defineEmits<{
+  (e: 'navigate', item: BreadcrumbItem, index: number): void;
+}>();
+
+const handleClick = (item: BreadcrumbItem, index: number) => {
+  // 点击最后一项不触发导航
+  if (index < props.items.length - 1) {
+    emit('navigate', item, index);
+  }
+};
+</script>
+
+<style scoped>
+.file-breadcrumb {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.125rem;
+  overflow-x: auto;
+  padding: 0 0.25rem;
+  max-width: 100%;
+  scrollbar-width: none;
+  -ms-overflow-style: none;
+  -webkit-app-region: no-drag; /* 面包屑内容不可拖拽，但空白区域可拖拽 */
+}
+
+.file-breadcrumb::-webkit-scrollbar {
+  display: none;
+}
+
+.file-breadcrumb-item {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+}
+
+.file-breadcrumb-link {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: 0.25rem 0.5rem;
+  border-radius: 0.375rem;
+  font-size: 0.875rem;
+  transition: all 200ms;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  color: rgb(75, 85, 99);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.file-breadcrumb-link:hover {
+  background: rgba(229, 231, 233, 0.6);
+  color: rgb(17, 24, 39);
+}
+
+.file-breadcrumb-link--current {
+  font-weight: 600;
+  color: rgb(17, 24, 39);
+  background: rgba(229, 231, 233, 0.5);
+  cursor: default;
+}
+
+.file-breadcrumb-link--current:hover {
+  background: rgba(229, 231, 233, 0.5);
+}
+
+.file-breadcrumb-separator {
+  color: rgb(156, 163, 175);
+  margin: 0 0.25rem;
+  flex-shrink: 0;
+}
+</style>