@huyooo/file-explorer-frontend-react 0.4.2

package/src/types/index.ts

@@ -0,0 +1,274 @@
+/**
+ * 文件类型（使用 const object 而非 enum，更好的 tree-shaking）
+ */
+export const FileType = {
+  FOLDER: 'folder',
+  FILE: 'file',
+  IMAGE: 'image',
+  VIDEO: 'video',
+  MUSIC: 'music',
+  DOCUMENT: 'document',
+  CODE: 'code',
+  TEXT: 'text',
+  PDF: 'pdf',
+  ARCHIVE: 'archive',
+  APPLICATION: 'application',
+  UNKNOWN: 'unknown'
+} as const;
+
+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[];
+}
+

package/src/utils/fileTypeIcon.ts

@@ -0,0 +1,309 @@
+import { FileType } from '../types';
+
+/**
+ * 文件图标映射（基于 material-icon-theme.json）
+ *
+ * 原理：
+ * 1. KNOWN_TYPES：从 material-icon-theme.json 提取的所有图标名
+ * 2. EXT_MAP：扩展名 → 图标名
+ * 3. SPECIAL_FILES：特殊文件名 → 图标名
+ * 4. 逻辑：特殊文件名匹配 → 扩展名匹配 → 兜底
+ */
+
+// 从 material-icon-theme.json 提取的所有图标名（~200 个常用）
+const KNOWN_TYPES = new Set([
+  '3d', 'actionscript', 'ada', 'adobe-illustrator', 'adobe-photoshop', 'android',
+  'angular', 'applescript', 'arduino', 'asciidoc', 'assembly', 'astro', 'audio',
+  'aurelia', 'babel', 'ballerina', 'bazel', 'biome', 'blender', 'bower', 'bun',
+  'c', 'cabal', 'caddy', 'cake', 'certificate', 'changelog', 'circleci', 'claude',
+  'clojure', 'cmake', 'cobol', 'coffee', 'command', 'conduct', 'contributing',
+  'controller', 'copilot', 'cpp', 'crystal', 'csharp', 'css', 'css-map', 'cucumber',
+  'cuda', 'cursor', 'cypress', 'd', 'dart', 'database', 'deno', 'dependabot', 'diff',
+  'django', 'docker', 'document', 'drawio', 'drizzle', 'editorconfig', 'ejs',
+  'elixir', 'elm', 'email', 'ember', 'epub', 'erlang', 'esbuild', 'eslint',
+  'excalidraw', 'exe', 'favicon', 'figma', 'firebase', 'flash', 'flow', 'font',
+  'forth', 'fortran', 'freemarker', 'fsharp', 'gamemaker', 'gatsby', 'gcp', 'gemfile',
+  'gemini', 'git', 'gitlab', 'gleam', 'go', 'go-mod', 'godot', 'gradle', 'graphql',
+  'groovy', 'grunt', 'gulp', 'h', 'haml', 'handlebars', 'hardhat', 'haskell', 'haxe',
+  'hcl', 'helm', 'hjson', 'hosts', 'hpp', 'html', 'http', 'husky', 'i18n', 'image',
+  'imba', 'ionic', 'jar', 'java', 'javaclass', 'javascript', 'javascript-map',
+  'jenkins', 'jest', 'jinja', 'jsconfig', 'json', 'julia', 'jupyter', 'just',
+  'karma', 'key', 'kotlin', 'kubernetes', 'laravel', 'lean', 'lefthook', 'lerna',
+  'less', 'lib', 'license', 'lighthouse', 'liquid', 'lisp', 'livescript', 'lock',
+  'log', 'lua', 'luau', 'makefile', 'markdown', 'markdownlint', 'matlab', 'maven',
+  'mdx', 'mercurial', 'mermaid', 'meson', 'minecraft', 'mjml', 'mocha', 'mojo',
+  'nest', 'netlify', 'next', 'nginx', 'nim', 'nix', 'nodejs', 'nodemon', 'npm',
+  'nuget', 'nunjucks', 'nuxt', 'nx', 'objective-c', 'objective-cpp', 'ocaml', 'odin',
+  'openapi', 'opentofu', 'pascal', 'pdf', 'perl', 'php', 'phpstan', 'phpunit',
+  'pipeline', 'playwright', 'pnpm', 'postcss', 'powerpoint', 'powershell', 'prettier',
+  'prisma', 'processing', 'prolog', 'proto', 'pug', 'puppet', 'purescript', 'python',
+  'pytorch', 'quasar', 'r', 'racket', 'razor', 'react', 'react-ts', 'readme', 'reason',
+  'remark', 'remix', 'renovate', 'replit', 'rescript', 'riot', 'roadmap', 'robot',
+  'robots', 'rollup', 'routing', 'rspec', 'rubocop', 'ruby', 'ruff', 'rust', 'salt',
+  'san', 'sas', 'sass', 'sbt', 'scala', 'scheme', 'search', 'sentry', 'sequelize',
+  'serverless', 'settings', 'shader', 'shellcheck', 'sketch', 'slim', 'slint',
+  'smarty', 'snakemake', 'snapcraft', 'snyk', 'solidity', 'spwn', 'stackblitz',
+  'stan', 'stencil', 'storybook', 'stryker', 'stylelint', 'stylus', 'sublime',
+  'subtitles', 'supabase', 'svelte', 'svg', 'svgo', 'swagger', 'swc', 'swift',
+  'tailwindcss', 'taskfile', 'tauri', 'tcl', 'teal', 'templ', 'template', 'terraform',
+  'test-js', 'test-jsx', 'test-ts', 'tex', 'todo', 'toml', 'travis', 'tree', 'tsconfig',
+  'tsdoc', 'turborepo', 'twig', 'typescript', 'typescript-def', 'unity', 'unocss',
+  'vagrant', 'vanilla-extract', 'vercel', 'verilog', 'video', 'vim', 'vite', 'vitest',
+  'vlang', 'vscode', 'vue', 'vue-config', 'wakatime', 'wallaby', 'webassembly',
+  'webhint', 'webpack', 'windicss', 'word', 'wrangler', 'wxt', 'xaml', 'xmake',
+  'xml', 'yaml', 'yarn', 'zig', 'zip',
+]);
+
+// 扩展名 → 图标名
+const EXT_MAP: Record<string, string> = {
+  // JavaScript/TypeScript
+  'js': 'javascript', 'mjs': 'javascript', 'cjs': 'javascript',
+  'jsx': 'react',
+  'ts': 'typescript', 'mts': 'typescript', 'cts': 'typescript',
+  'tsx': 'react-ts',
+  // 前端框架
+  'vue': 'vue',
+  'svelte': 'svelte',
+  'astro': 'astro',
+  // 后端语言
+  'py': 'python', 'pyw': 'python', 'pyi': 'python', 'pyc': 'python',
+  'java': 'java', 'class': 'javaclass', 'jar': 'jar',
+  'c': 'c', 'h': 'h',
+  'cpp': 'cpp', 'cc': 'cpp', 'cxx': 'cpp', 'hpp': 'hpp', 'hh': 'hpp', 'hxx': 'hpp',
+  'cs': 'csharp', 'csx': 'csharp',
+  'go': 'go',
+  'rs': 'rust',
+  'php': 'php', 'phtml': 'php',
+  'rb': 'ruby', 'rake': 'ruby',
+  'swift': 'swift',
+  'kt': 'kotlin', 'kts': 'kotlin',
+  'scala': 'scala',
+  'dart': 'dart',
+  'lua': 'lua', 'luau': 'luau',
+  'r': 'r', 'rdata': 'r', 'rds': 'r',
+  'pl': 'perl', 'pm': 'perl',
+  'sh': 'command', 'bash': 'command', 'zsh': 'command', 'fish': 'command',
+  'ps1': 'powershell', 'psm1': 'powershell', 'psd1': 'powershell',
+  'bat': 'command', 'cmd': 'command',
+  // 样式
+  'css': 'css',
+  'scss': 'sass', 'sass': 'sass',
+  'less': 'less',
+  'styl': 'stylus',
+  // 标记/配置
+  'html': 'html', 'htm': 'html', 'xhtml': 'html',
+  'xml': 'xml', 'xsl': 'xml', 'xslt': 'xml',
+  'json': 'json', 'jsonc': 'json', 'json5': 'json',
+  'yaml': 'yaml', 'yml': 'yaml',
+  'toml': 'toml',
+  'ini': 'settings',
+  'conf': 'settings', 'config': 'settings',
+  // 文档
+  'md': 'markdown', 'markdown': 'markdown', 'mdx': 'mdx',
+  'txt': 'document',
+  'pdf': 'pdf',
+  'doc': 'word', 'docx': 'word', 'dot': 'word', 'dotx': 'word', 'odt': 'word',
+  'xls': 'table', 'xlsx': 'table', 'xlsm': 'table', 'ods': 'table', 'csv': 'table',
+  'ppt': 'powerpoint', 'pptx': 'powerpoint', 'odp': 'powerpoint',
+  // 图片
+  'jpg': 'image', 'jpeg': 'image', 'png': 'image', 'gif': 'image', 'webp': 'image',
+  'ico': 'image', 'bmp': 'image', 'tiff': 'image', 'tif': 'image', 'heic': 'image', 'heif': 'image',
+  'svg': 'svg',
+  'psd': 'adobe-photoshop',
+  'ai': 'adobe-illustrator',
+  'sketch': 'sketch',
+  'fig': 'figma', 'figma': 'figma',
+  // 视频/音频
+  'mp4': 'video', 'mov': 'video', 'avi': 'video', 'mkv': 'video', 'webm': 'video',
+  'flv': 'video', 'wmv': 'video', 'm4v': 'video', '3gp': 'video', 'mpeg': 'video', 'mpg': 'video',
+  'mp3': 'audio', 'wav': 'audio', 'flac': 'audio', 'aac': 'audio', 'ogg': 'audio',
+  'wma': 'audio', 'm4a': 'audio', 'aiff': 'audio',
+  // 压缩
+  'zip': 'zip', 'rar': 'zip', '7z': 'zip', 'tar': 'zip', 'gz': 'zip', 'bz2': 'zip',
+  'xz': 'zip', 'tgz': 'zip', 'tbz2': 'zip',
+  // 数据库
+  'sql': 'database',
+  'db': 'database', 'sqlite': 'database', 'sqlite3': 'database',
+  'prisma': 'prisma',
+  // 其他
+  'log': 'log',
+  'lock': 'lock',
+  'env': 'settings',
+  'graphql': 'graphql', 'gql': 'graphql',
+  'proto': 'proto',
+  'wasm': 'webassembly',
+  'zig': 'zig',
+  'nim': 'nim',
+  'nix': 'nix',
+  'hcl': 'hcl', 'tf': 'terraform',
+  'sol': 'solidity',
+  'ex': 'elixir', 'exs': 'elixir',
+  'erl': 'erlang', 'hrl': 'erlang',
+  'hs': 'haskell', 'lhs': 'haskell',
+  'ml': 'ocaml', 'mli': 'ocaml',
+  'clj': 'clojure', 'cljs': 'clojure', 'cljc': 'clojure',
+  'lisp': 'lisp', 'lsp': 'lisp', 'el': 'lisp',
+  'vim': 'vim',
+  'dockerfile': 'docker',
+};
+
+// 特殊文件名 → 图标名
+const SPECIAL_FILES: Record<string, string> = {
+  // Git
+  '.gitignore': 'git', '.gitattributes': 'git', '.gitmodules': 'git', '.gitkeep': 'git',
+  // 环境
+  '.env': 'settings', '.env.local': 'settings', '.env.development': 'settings',
+  '.env.production': 'settings', '.env.test': 'settings', '.env.example': 'settings',
+  // Node/包管理
+  'package.json': 'nodejs', 'package-lock.json': 'npm',
+  'yarn.lock': 'yarn', '.yarnrc': 'yarn', '.yarnrc.yml': 'yarn',
+  'pnpm-lock.yaml': 'pnpm', '.pnpmfile.cjs': 'pnpm',
+  'bun.lockb': 'bun', 'bunfig.toml': 'bun',
+  // Python
+  'requirements.txt': 'python', 'pipfile': 'python', 'pipfile.lock': 'python',
+  'pyproject.toml': 'python', 'poetry.lock': 'python', 'setup.py': 'python',
+  // Rust
+  'cargo.toml': 'rust', 'cargo.lock': 'rust',
+  // Go
+  'go.mod': 'go-mod', 'go.sum': 'go-mod', 'go.work': 'go-mod',
+  // PHP
+  'composer.json': 'php', 'composer.lock': 'php',
+  // Ruby
+  'gemfile': 'gemfile', 'gemfile.lock': 'gemfile', 'rakefile': 'ruby',
+  // Docker
+  'dockerfile': 'docker', 'docker-compose.yml': 'docker', 'docker-compose.yaml': 'docker',
+  '.dockerignore': 'docker',
+  // 构建工具
+  'makefile': 'makefile', 'gnumakefile': 'makefile',
+  'cmakelists.txt': 'cmake',
+  'build.gradle': 'gradle', 'build.gradle.kts': 'gradle', 'settings.gradle': 'gradle',
+  'pom.xml': 'maven',
+  // 配置
+  'tsconfig.json': 'tsconfig', 'jsconfig.json': 'jsconfig',
+  '.prettierrc': 'prettier', '.prettierrc.json': 'prettier', '.prettierrc.js': 'prettier',
+  '.prettierignore': 'prettier', 'prettier.config.js': 'prettier',
+  '.eslintrc': 'eslint', '.eslintrc.json': 'eslint', '.eslintrc.js': 'eslint',
+  '.eslintignore': 'eslint', 'eslint.config.js': 'eslint', 'eslint.config.mjs': 'eslint',
+  '.editorconfig': 'editorconfig',
+  'vite.config.ts': 'vite', 'vite.config.js': 'vite',
+  'webpack.config.js': 'webpack', 'webpack.config.ts': 'webpack',
+  'rollup.config.js': 'rollup', 'rollup.config.ts': 'rollup',
+  'esbuild.config.js': 'esbuild',
+  'tailwind.config.js': 'tailwindcss', 'tailwind.config.ts': 'tailwindcss',
+  'postcss.config.js': 'postcss', 'postcss.config.cjs': 'postcss',
+  'babel.config.js': 'babel', '.babelrc': 'babel',
+  'jest.config.js': 'jest', 'jest.config.ts': 'jest',
+  'vitest.config.ts': 'vitest', 'vitest.config.js': 'vitest',
+  'playwright.config.ts': 'playwright', 'playwright.config.js': 'playwright',
+  'cypress.config.ts': 'cypress', 'cypress.config.js': 'cypress',
+  '.swcrc': 'swc', 'swc.config.js': 'swc',
+  'turbo.json': 'turborepo',
+  'nx.json': 'nx',
+  'biome.json': 'biome',
+  '.nvmrc': 'nodejs', '.node-version': 'nodejs',
+  // 框架配置
+  'nuxt.config.ts': 'nuxt', 'nuxt.config.js': 'nuxt',
+  'next.config.js': 'next', 'next.config.mjs': 'next', 'next.config.ts': 'next',
+  'svelte.config.js': 'svelte',
+  'astro.config.mjs': 'astro', 'astro.config.ts': 'astro',
+  'vue.config.js': 'vue-config',
+  'angular.json': 'angular',
+  'nest-cli.json': 'nest',
+  'tauri.conf.json': 'tauri',
+  // CI/CD
+  '.travis.yml': 'travis',
+  '.gitlab-ci.yml': 'gitlab',
+  'vercel.json': 'vercel',
+  'netlify.toml': 'netlify',
+  // 其他
+  'license': 'license', 'license.md': 'license', 'license.txt': 'license',
+  'readme': 'readme', 'readme.md': 'readme', 'readme.txt': 'readme',
+  'changelog': 'changelog', 'changelog.md': 'changelog',
+  '.npmrc': 'npm', '.npmignore': 'npm',
+  'robots.txt': 'robots',
+  '.htaccess': 'nginx',
+  'vagrantfile': 'vagrant',
+  '.stylelintrc': 'stylelint', '.stylelintrc.json': 'stylelint',
+  'nodemon.json': 'nodemon',
+  '.huskyrc': 'husky',
+  'renovate.json': 'renovate',
+  '.snyk': 'snyk',
+  'deno.json': 'deno', 'deno.jsonc': 'deno',
+};
+
+/**
+ * 根据文件名获取 material-icon-theme 图标名称
+ */
+export function getFileTypeIcon(fileName: string, fallbackType?: FileType): string {
+  const lowerName = fileName.toLowerCase();
+
+  // 1. 特殊文件名匹配
+  if (SPECIAL_FILES[lowerName]) {
+    const type = SPECIAL_FILES[lowerName];
+    if (KNOWN_TYPES.has(type)) {
+      return `material-icon-theme:${type}`;
+    }
+  }
+
+  // 2. Dockerfile 特殊处理
+  if (lowerName === 'dockerfile' || lowerName.startsWith('dockerfile.')) {
+    return 'material-icon-theme:docker';
+  }
+
+  // 3. .env 变体处理
+  if (lowerName === '.env' || lowerName.startsWith('.env.')) {
+    return 'material-icon-theme:settings';
+  }
+
+  // 4. 提取扩展名并匹配
+  const lastDotIndex = fileName.lastIndexOf('.');
+  const ext = lastDotIndex > 0 ? fileName.substring(lastDotIndex + 1).toLowerCase() : '';
+
+  // 处理复合扩展名
+  if (ext === 'ts' || ext === 'js') {
+    const baseName = fileName.substring(0, lastDotIndex).toLowerCase();
+    if (baseName.endsWith('.d')) {
+      return 'material-icon-theme:typescript-def';
+    }
+    if (baseName.endsWith('.test') || baseName.endsWith('.spec')) {
+      return ext === 'ts' ? 'material-icon-theme:test-ts' : 'material-icon-theme:test-js';
+    }
+  }
+  if (ext === 'jsx' || ext === 'tsx') {
+    const baseName = fileName.substring(0, lastDotIndex).toLowerCase();
+    if (baseName.endsWith('.test') || baseName.endsWith('.spec')) {
+      return ext === 'tsx' ? 'material-icon-theme:test-ts' : 'material-icon-theme:test-jsx';
+    }
+  }
+
+  if (ext && EXT_MAP[ext]) {
+    const type = EXT_MAP[ext];
+    if (KNOWN_TYPES.has(type)) {
+      return `material-icon-theme:${type}`;
+    }
+  }
+
+  // 5. 根据 fallbackType 返回兜底图标
+  if (fallbackType) {
+    return getFallbackIcon(fallbackType);
+  }
+
+  // 6. 最终兜底
+  return 'material-icon-theme:document';
+}
+
+function getFallbackIcon(type: FileType): string {
+  switch (type) {
+    case FileType.IMAGE: return 'material-icon-theme:image';
+    case FileType.VIDEO: return 'material-icon-theme:video';
+    case FileType.MUSIC: return 'material-icon-theme:audio';
+    case FileType.CODE: return 'material-icon-theme:javascript';
+    case FileType.TEXT: return 'material-icon-theme:document';
+    case FileType.DOCUMENT: return 'material-icon-theme:word';
+    case FileType.PDF: return 'material-icon-theme:pdf';
+    case FileType.ARCHIVE: return 'material-icon-theme:zip';
+    case FileType.APPLICATION: return 'material-icon-theme:exe';
+    default: return 'material-icon-theme:document';
+  }
+}
+