@ai-matrx/media 0.8.0 → 0.9.0

package/dist/files/engine/utils/file-types.js

@@ -0,0 +1,1722 @@
+import {
+  Archive,
+  Braces,
+  Code,
+  Database,
+  File as FileIcon,
+  FileCode,
+  FileJson,
+  FileSpreadsheet,
+  FileText,
+  FileType,
+  Folder,
+  FolderOpen,
+  Image as ImageIcon,
+  Music,
+  Package,
+  PenTool,
+  Subtitles,
+  Video
+} from "lucide-react";
+const MAX_INLINE_PREVIEW_BYTES = 10 * 1024 * 1024;
+const FILE_TYPES = [
+  // ────────────────────── IMAGE ──────────────────────
+  {
+    extensions: ["jpg", "jpeg"],
+    mime: "image/jpeg",
+    category: "IMAGE",
+    subCategory: "JPEG",
+    displayName: "JPEG image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  {
+    extensions: ["png"],
+    mime: "image/png",
+    category: "IMAGE",
+    subCategory: "PNG",
+    displayName: "PNG image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  {
+    extensions: ["gif"],
+    mime: "image/gif",
+    category: "IMAGE",
+    subCategory: "GIF",
+    displayName: "GIF image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  {
+    extensions: ["webp"],
+    mime: "image/webp",
+    category: "IMAGE",
+    subCategory: "WEBP",
+    displayName: "WebP image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  // AVIF — modern image format, supported natively by all evergreen browsers.
+  {
+    extensions: ["avif"],
+    mime: "image/avif",
+    category: "IMAGE",
+    subCategory: "AVIF",
+    displayName: "AVIF image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  // SVG is text-under-the-hood (XML) so it gets its own previewKind. The
+  // SvgPreview renderer shows the rasterized vector on a transparency grid
+  // and exposes a "Source" toggle for the raw markup; the inline Monaco
+  // editor opens it as XML for direct edits. A distinct PenTool icon flags
+  // it as vector rather than the generic raster ImageIcon used by PNG/JPG.
+  {
+    extensions: ["svg"],
+    mime: "image/svg+xml",
+    category: "IMAGE",
+    subCategory: "SVG",
+    displayName: "SVG image",
+    previewKind: "svg",
+    thumbnailStrategy: "image",
+    color: "text-amber-500",
+    icon: PenTool
+  },
+  // HEIC / HEIF — Apple still uses these heavily. The canonical asset
+  // pipeline emits an aspect-preserving JPEG `preview_url` plus universal
+  // thumbnail variants; clients never bind the source bytes to `<img>`.
+  {
+    extensions: ["heic"],
+    mime: "image/heic",
+    category: "IMAGE",
+    subCategory: "HEIC",
+    displayName: "HEIC image (iOS)",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  {
+    extensions: ["heif"],
+    mime: "image/heif",
+    category: "IMAGE",
+    subCategory: "HEIF",
+    displayName: "HEIF image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  // BMP / TIFF — older raster formats. Browser support is uneven (TIFF only
+  // on Safari) but `<img>` will fail gracefully to the icon on others.
+  {
+    extensions: ["bmp"],
+    mime: "image/bmp",
+    category: "IMAGE",
+    subCategory: "BMP",
+    displayName: "Bitmap image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  {
+    extensions: ["tif", "tiff"],
+    mime: "image/tiff",
+    category: "IMAGE",
+    subCategory: "TIFF",
+    displayName: "TIFF image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  {
+    extensions: ["ico"],
+    mime: "image/x-icon",
+    category: "IMAGE",
+    subCategory: "ICO",
+    displayName: "Icon image",
+    previewKind: "image",
+    thumbnailStrategy: "image",
+    color: "text-emerald-500",
+    icon: ImageIcon
+  },
+  // ────────────────────── VIDEO ──────────────────────
+  // Video gets a `video-poster` thumbnail strategy: a muted, tiny `<video>`
+  // element renders the first frame in place of a generic icon.
+  {
+    extensions: ["mp4"],
+    mime: "video/mp4",
+    category: "VIDEO",
+    subCategory: "MP4",
+    displayName: "MP4 video",
+    previewKind: "video",
+    thumbnailStrategy: "video-poster",
+    color: "text-purple-500",
+    icon: Video,
+    previewSizeCapOverride: null
+    // streamed inline — no cap
+  },
+  {
+    extensions: ["mov"],
+    mime: "video/quicktime",
+    category: "VIDEO",
+    subCategory: "MOV",
+    displayName: "QuickTime video",
+    previewKind: "video",
+    thumbnailStrategy: "video-poster",
+    color: "text-purple-500",
+    icon: Video,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["webm"],
+    mime: "video/webm",
+    category: "VIDEO",
+    subCategory: "WEBM",
+    displayName: "WebM video",
+    previewKind: "video",
+    thumbnailStrategy: "video-poster",
+    color: "text-purple-500",
+    icon: Video,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["mkv"],
+    mime: "video/x-matroska",
+    category: "VIDEO",
+    subCategory: "MKV",
+    displayName: "Matroska video",
+    previewKind: "video",
+    thumbnailStrategy: "video-poster",
+    color: "text-purple-500",
+    icon: Video,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["avi"],
+    mime: "video/x-msvideo",
+    category: "VIDEO",
+    subCategory: "AVI",
+    displayName: "AVI video",
+    previewKind: "video",
+    thumbnailStrategy: "video-poster",
+    color: "text-purple-500",
+    icon: Video,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["m4v"],
+    mime: "video/mp4",
+    category: "VIDEO",
+    subCategory: "M4V",
+    displayName: "iTunes video",
+    previewKind: "video",
+    thumbnailStrategy: "video-poster",
+    color: "text-purple-500",
+    icon: Video,
+    previewSizeCapOverride: null
+  },
+  // ────────────────────── AUDIO ──────────────────────
+  // Audio thumbs stay as icons — waveform extraction is not worth the
+  // bundle cost. Long-term: a backend cover-art / waveform field.
+  {
+    extensions: ["mp3"],
+    mime: "audio/mpeg",
+    category: "AUDIO",
+    subCategory: "MP3",
+    displayName: "MP3 audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["wav"],
+    mime: "audio/wav",
+    category: "AUDIO",
+    subCategory: "WAV",
+    displayName: "WAV audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["ogg"],
+    mime: "audio/ogg",
+    category: "AUDIO",
+    subCategory: "OGG",
+    displayName: "Ogg audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["m4a"],
+    mime: "audio/mp4",
+    category: "AUDIO",
+    subCategory: "M4A",
+    displayName: "AAC audio (M4A)",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["aac"],
+    mime: "audio/aac",
+    category: "AUDIO",
+    subCategory: "AAC",
+    displayName: "AAC audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["flac"],
+    mime: "audio/flac",
+    category: "AUDIO",
+    subCategory: "FLAC",
+    displayName: "FLAC audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["opus"],
+    mime: "audio/opus",
+    category: "AUDIO",
+    subCategory: "OPUS",
+    displayName: "Opus audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  // MIME-only — `.webm` extension stays mapped to VIDEO below because the
+  // container can hold either track type. Rows whose server MIME is
+  // `audio/webm` (MediaRecorder speech captures, FastFire, transcripts)
+  // resolve via BY_MIME in `getFilePreviewProfile`. See
+  // docs/files/transcript-recordings-system-relocation.md.
+  {
+    extensions: [],
+    mime: "audio/webm",
+    category: "AUDIO",
+    subCategory: "WEBM",
+    displayName: "WebM audio",
+    previewKind: "audio",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Music,
+    previewSizeCapOverride: null
+  },
+  // ────────────────────── PDF ──────────────────────
+  {
+    extensions: ["pdf"],
+    mime: "application/pdf",
+    category: "DOCUMENT",
+    subCategory: "PDF",
+    displayName: "PDF document",
+    previewKind: "pdf",
+    // First-page render via pdfjs is a future enhancement. For now we use the
+    // category icon — pdfjs is too heavy to load just for thumbs in a folder
+    // listing. When backend thumbs land we'll switch this to "backend-thumb".
+    thumbnailStrategy: "icon",
+    color: "text-red-500",
+    icon: FileType,
+    previewSizeCapOverride: null
+  },
+  // ────────────────────── MARKDOWN ──────────────────────
+  {
+    extensions: ["md", "markdown"],
+    mime: "text/markdown",
+    category: "DOCUMENT",
+    subCategory: "MARKDOWN",
+    displayName: "Markdown",
+    previewKind: "markdown",
+    thumbnailStrategy: "icon",
+    color: "text-slate-400",
+    icon: FileText
+  },
+  {
+    extensions: ["mdx"],
+    mime: "text/markdown",
+    category: "DOCUMENT",
+    subCategory: "MDX",
+    displayName: "MDX (Markdown + JSX)",
+    previewKind: "markdown",
+    thumbnailStrategy: "icon",
+    color: "text-slate-400",
+    icon: FileText
+  },
+  // ────────────────────── PLAIN TEXT / LOG / SUBTITLES ──────────────────────
+  {
+    extensions: ["txt", "text", "asc", "me"],
+    aliases: [
+      // Project metadata that ships without an extension
+      "README",
+      "Readme",
+      "readme",
+      "LICENSE",
+      "License",
+      "license",
+      "LICENCE",
+      "COPYING",
+      "COPYRIGHT",
+      "NOTICE",
+      "AUTHORS",
+      "CONTRIBUTORS",
+      "MAINTAINERS",
+      "CHANGELOG",
+      "CHANGES",
+      "HISTORY",
+      "NEWS",
+      "TODO",
+      "INSTALL",
+      "VERSION",
+      "MANIFEST",
+      "PATENTS",
+      "ROADMAP",
+      "SECURITY"
+    ],
+    mime: "text/plain",
+    category: "DOCUMENT",
+    subCategory: "PLAIN",
+    displayName: "Plain text",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-muted-foreground",
+    icon: FileText
+  },
+  {
+    extensions: ["log", "out", "err"],
+    mime: "text/plain",
+    category: "DOCUMENT",
+    subCategory: "LOG",
+    displayName: "Log file",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-muted-foreground",
+    icon: FileText
+  },
+  // Dockerfile-family — text with custom syntax. We keep them in the CODE
+  // category so they get a syntax-highlighting language hint downstream.
+  {
+    extensions: ["dockerfile", "containerfile"],
+    aliases: ["Dockerfile", "Containerfile", "dockerfile"],
+    aliasPrefixes: ["Dockerfile.", "dockerfile.", "Containerfile."],
+    mime: "text/x-dockerfile",
+    category: "CODE",
+    subCategory: "DOCKERFILE",
+    displayName: "Dockerfile",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-500",
+    icon: Code
+  },
+  // Makefile-family — also custom-syntax text.
+  {
+    extensions: ["mk", "make"],
+    aliases: [
+      "Makefile",
+      "makefile",
+      "GNUmakefile",
+      "BSDmakefile",
+      "Procfile",
+      "Pipfile",
+      "Justfile",
+      "justfile",
+      "Earthfile"
+    ],
+    aliasPrefixes: ["Makefile.", "makefile."],
+    mime: "text/x-makefile",
+    category: "CODE",
+    subCategory: "MAKEFILE",
+    displayName: "Makefile",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-orange-500",
+    icon: Code
+  },
+  // Patches & diffs — text.
+  {
+    extensions: ["diff", "patch"],
+    mime: "text/x-diff",
+    category: "CODE",
+    subCategory: "PATCH",
+    displayName: "Patch / diff",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: FileText
+  },
+  // INI / properties / cfg — historically common config text formats.
+  {
+    extensions: ["ini", "cfg", "conf", "config", "properties", "prefs"],
+    mime: "text/x-properties",
+    category: "CODE",
+    subCategory: "CONFIG",
+    displayName: "Config file",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-amber-400",
+    icon: Braces
+  },
+  // BibTeX / TeX / LaTeX — plain text with markup.
+  {
+    extensions: ["tex", "latex", "ltx", "sty", "cls", "bib"],
+    mime: "text/x-tex",
+    category: "CODE",
+    subCategory: "TEX",
+    displayName: "TeX / LaTeX",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-500",
+    icon: FileText
+  },
+  // reStructuredText / AsciiDoc — text doc formats.
+  {
+    extensions: ["rst", "adoc", "asciidoc", "org"],
+    mime: "text/plain",
+    category: "DOCUMENT",
+    subCategory: "DOC",
+    displayName: "Document",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-slate-400",
+    icon: FileText
+  },
+  {
+    extensions: ["srt"],
+    mime: "application/x-subrip",
+    category: "SUBTITLES",
+    subCategory: "SRT",
+    displayName: "SubRip subtitles",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-cyan-500",
+    icon: Subtitles
+  },
+  {
+    extensions: ["vtt"],
+    mime: "text/vtt",
+    category: "SUBTITLES",
+    subCategory: "VTT",
+    displayName: "WebVTT subtitles",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-cyan-500",
+    icon: Subtitles
+  },
+  // ────────────────────── CODE ──────────────────────
+  {
+    extensions: ["js", "mjs", "cjs"],
+    mime: "text/javascript",
+    category: "CODE",
+    subCategory: "JAVASCRIPT",
+    displayName: "JavaScript",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-yellow-500",
+    icon: FileCode
+  },
+  {
+    extensions: ["jsx"],
+    mime: "text/javascript",
+    category: "CODE",
+    subCategory: "JAVASCRIPT",
+    displayName: "JSX",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-yellow-500",
+    icon: FileCode
+  },
+  {
+    extensions: ["ts"],
+    mime: "text/typescript",
+    category: "CODE",
+    subCategory: "TYPESCRIPT",
+    displayName: "TypeScript",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-500",
+    icon: FileCode
+  },
+  {
+    extensions: ["tsx"],
+    mime: "text/typescript",
+    category: "CODE",
+    subCategory: "TYPESCRIPT",
+    displayName: "TSX",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-500",
+    icon: FileCode
+  },
+  {
+    extensions: ["py"],
+    mime: "text/x-python",
+    category: "CODE",
+    subCategory: "PYTHON",
+    displayName: "Python",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-500",
+    icon: Code
+  },
+  {
+    extensions: ["rb", "rbw", "rake", "ru", "gemspec"],
+    aliases: [
+      "Rakefile",
+      "Gemfile",
+      "Vagrantfile",
+      "Berksfile",
+      "Brewfile",
+      "Capfile",
+      "Guardfile",
+      "Podfile",
+      "Fastfile",
+      "Appfile",
+      "Deliverfile",
+      "Matchfile",
+      "Pluginfile",
+      "Snapfile",
+      "Scanfile",
+      "Gymfile"
+    ],
+    mime: "text/x-ruby",
+    category: "CODE",
+    subCategory: "RUBY",
+    displayName: "Ruby",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-red-500",
+    icon: Code
+  },
+  {
+    extensions: ["go"],
+    mime: "text/x-go",
+    category: "CODE",
+    subCategory: "GO",
+    displayName: "Go",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-cyan-500",
+    icon: Code
+  },
+  {
+    extensions: ["rs"],
+    mime: "text/x-rust",
+    category: "CODE",
+    subCategory: "RUST",
+    displayName: "Rust",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-orange-600",
+    icon: Code
+  },
+  {
+    extensions: ["java"],
+    mime: "text/x-java",
+    category: "CODE",
+    subCategory: "JAVA",
+    displayName: "Java",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-red-600",
+    icon: Code
+  },
+  {
+    extensions: ["swift"],
+    mime: "text/x-swift",
+    category: "CODE",
+    subCategory: "SWIFT",
+    displayName: "Swift",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-orange-500",
+    icon: Code
+  },
+  {
+    extensions: ["c", "h"],
+    mime: "text/x-c",
+    category: "CODE",
+    subCategory: "C",
+    displayName: "C",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-600",
+    icon: Code
+  },
+  {
+    extensions: ["cpp", "cc", "cxx", "hpp"],
+    mime: "text/x-c++",
+    category: "CODE",
+    subCategory: "CPP",
+    displayName: "C++",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-700",
+    icon: Code
+  },
+  {
+    extensions: ["cs"],
+    mime: "text/x-csharp",
+    category: "CODE",
+    subCategory: "CSHARP",
+    displayName: "C#",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-purple-600",
+    icon: Code
+  },
+  // HTML — `previewKind: "html"` so the previewer can offer a Rendered /
+  // Source toggle (sandboxed iframe vs syntax-highlighted markup). Without
+  // the split, opening a saved web page in /files just showed its source,
+  // which is the wrong default for almost every consumer. The Edit tab
+  // mounts Monaco with `html` language (see CloudFileInlineEditor's
+  // LANGUAGE_BY_EXT) and source-of-truth editing happens there.
+  {
+    extensions: ["html", "htm"],
+    mime: "text/html",
+    category: "CODE",
+    subCategory: "HTML",
+    displayName: "HTML",
+    previewKind: "html",
+    thumbnailStrategy: "icon",
+    color: "text-orange-400",
+    icon: Code
+  },
+  {
+    extensions: ["css"],
+    mime: "text/css",
+    category: "CODE",
+    subCategory: "CSS",
+    displayName: "CSS",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-sky-400",
+    icon: Code
+  },
+  {
+    extensions: ["scss"],
+    mime: "text/x-scss",
+    category: "CODE",
+    subCategory: "SCSS",
+    displayName: "SCSS",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-pink-400",
+    icon: Code
+  },
+  {
+    extensions: ["sh", "bash", "zsh", "fish", "ksh", "ash"],
+    aliases: [
+      // Bash / shell config dotfiles
+      ".bashrc",
+      ".bash_logout",
+      ".bash_profile",
+      ".bash_history",
+      ".bash_aliases",
+      ".profile",
+      ".zshrc",
+      ".zshenv",
+      ".zprofile",
+      ".zlogin",
+      ".zlogout",
+      ".zsh_history",
+      ".inputrc",
+      ".curlrc",
+      ".wgetrc",
+      ".npmrc",
+      ".yarnrc",
+      ".pypirc",
+      ".tool-versions",
+      ".nvmrc",
+      ".node-version",
+      ".python-version",
+      ".ruby-version",
+      // Env files (exact)
+      ".env",
+      ".envrc",
+      ".sandbox_env",
+      // Editor / formatter / linter config dotfiles (no extension variants)
+      ".editorconfig",
+      ".gitignore",
+      ".gitattributes",
+      ".gitmodules",
+      ".gitkeep",
+      ".gitconfig",
+      ".dockerignore",
+      ".eslintignore",
+      ".prettierignore",
+      ".npmignore",
+      ".browserslistrc",
+      ".stylelintignore",
+      ".rsync-filter",
+      // SSH / system config that is plain text
+      "authorized_keys",
+      "known_hosts",
+      "config",
+      "hosts",
+      "passwd",
+      "group",
+      "shadow",
+      "fstab",
+      "crontab",
+      "resolv.conf",
+      "ssh_config",
+      "sshd_config",
+      // Build / cache markers (text)
+      "CACHEDIR.TAG",
+      "CODEOWNERS"
+    ],
+    aliasPrefixes: [
+      // .env.local, .env.production, .env.development, .env.test, etc.
+      ".env.",
+      ".envrc."
+    ],
+    mime: "text/x-shellscript",
+    category: "CODE",
+    subCategory: "SHELL",
+    displayName: "Shell script",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-400",
+    icon: Code
+  },
+  {
+    extensions: ["sql"],
+    mime: "application/sql",
+    category: "CODE",
+    subCategory: "SQL",
+    displayName: "SQL",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-amber-400",
+    icon: Code
+  },
+  {
+    extensions: ["lua"],
+    mime: "text/x-lua",
+    category: "CODE",
+    subCategory: "LUA",
+    displayName: "Lua",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-500",
+    icon: Code
+  },
+  {
+    extensions: ["pl", "pm"],
+    mime: "text/x-perl",
+    category: "CODE",
+    subCategory: "PERL",
+    displayName: "Perl",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-indigo-400",
+    icon: Code
+  },
+  {
+    extensions: ["r", "R", "rmd", "Rmd"],
+    mime: "text/x-r",
+    category: "CODE",
+    subCategory: "R",
+    displayName: "R",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-400",
+    icon: Code
+  },
+  {
+    extensions: ["dart"],
+    mime: "text/x-dart",
+    category: "CODE",
+    subCategory: "DART",
+    displayName: "Dart",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-cyan-500",
+    icon: Code
+  },
+  {
+    extensions: ["kt", "kts"],
+    mime: "text/x-kotlin",
+    category: "CODE",
+    subCategory: "KOTLIN",
+    displayName: "Kotlin",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-orange-400",
+    icon: Code
+  },
+  {
+    extensions: ["scala", "sbt"],
+    mime: "text/x-scala",
+    category: "CODE",
+    subCategory: "SCALA",
+    displayName: "Scala",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-red-500",
+    icon: Code
+  },
+  {
+    extensions: ["clj", "cljs", "cljc", "edn"],
+    mime: "text/x-clojure",
+    category: "CODE",
+    subCategory: "CLOJURE",
+    displayName: "Clojure",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-500",
+    icon: Code
+  },
+  {
+    extensions: ["ex", "exs"],
+    mime: "text/x-elixir",
+    category: "CODE",
+    subCategory: "ELIXIR",
+    displayName: "Elixir",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-purple-400",
+    icon: Code
+  },
+  {
+    extensions: ["erl", "hrl"],
+    mime: "text/x-erlang",
+    category: "CODE",
+    subCategory: "ERLANG",
+    displayName: "Erlang",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-rose-500",
+    icon: Code
+  },
+  {
+    extensions: ["hs", "lhs"],
+    mime: "text/x-haskell",
+    category: "CODE",
+    subCategory: "HASKELL",
+    displayName: "Haskell",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-violet-500",
+    icon: Code
+  },
+  {
+    extensions: ["ml", "mli", "fs", "fsi", "fsx"],
+    mime: "text/x-ocaml",
+    category: "CODE",
+    subCategory: "ML",
+    displayName: "OCaml / F#",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-orange-500",
+    icon: Code
+  },
+  {
+    extensions: ["zig"],
+    mime: "text/x-zig",
+    category: "CODE",
+    subCategory: "ZIG",
+    displayName: "Zig",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-yellow-500",
+    icon: Code
+  },
+  {
+    extensions: ["nim", "nims"],
+    mime: "text/x-nim",
+    category: "CODE",
+    subCategory: "NIM",
+    displayName: "Nim",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-yellow-400",
+    icon: Code
+  },
+  {
+    extensions: ["jl"],
+    mime: "text/x-julia",
+    category: "CODE",
+    subCategory: "JULIA",
+    displayName: "Julia",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-purple-500",
+    icon: Code
+  },
+  {
+    extensions: ["vue"],
+    mime: "text/x-vue",
+    category: "CODE",
+    subCategory: "VUE",
+    displayName: "Vue",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-500",
+    icon: Code
+  },
+  {
+    extensions: ["svelte"],
+    mime: "text/x-svelte",
+    category: "CODE",
+    subCategory: "SVELTE",
+    displayName: "Svelte",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-orange-500",
+    icon: Code
+  },
+  {
+    extensions: ["astro"],
+    mime: "text/x-astro",
+    category: "CODE",
+    subCategory: "ASTRO",
+    displayName: "Astro",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-fuchsia-500",
+    icon: Code
+  },
+  {
+    extensions: ["graphql", "gql", "graphqls"],
+    mime: "application/graphql",
+    category: "CODE",
+    subCategory: "GRAPHQL",
+    displayName: "GraphQL",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-pink-500",
+    icon: Code
+  },
+  {
+    extensions: ["proto"],
+    mime: "text/x-protobuf",
+    category: "CODE",
+    subCategory: "PROTO",
+    displayName: "Protocol Buffers",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-400",
+    icon: Code
+  },
+  {
+    extensions: ["sol"],
+    mime: "text/x-solidity",
+    category: "CODE",
+    subCategory: "SOLIDITY",
+    displayName: "Solidity",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-slate-400",
+    icon: Code
+  },
+  {
+    extensions: ["bat", "cmd"],
+    mime: "text/x-msdos-batch",
+    category: "CODE",
+    subCategory: "BATCH",
+    displayName: "Batch script",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-400",
+    icon: Code
+  },
+  {
+    extensions: ["ps1", "psm1", "psd1"],
+    mime: "application/x-powershell",
+    category: "CODE",
+    subCategory: "POWERSHELL",
+    displayName: "PowerShell",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-400",
+    icon: Code
+  },
+  {
+    extensions: ["less"],
+    mime: "text/x-less",
+    category: "CODE",
+    subCategory: "LESS",
+    displayName: "LESS",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-blue-400",
+    icon: Code
+  },
+  {
+    extensions: ["styl", "stylus"],
+    mime: "text/x-stylus",
+    category: "CODE",
+    subCategory: "STYLUS",
+    displayName: "Stylus",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-500",
+    icon: Code
+  },
+  {
+    extensions: ["php", "phtml", "phps"],
+    mime: "application/x-php",
+    category: "CODE",
+    subCategory: "PHP",
+    displayName: "PHP",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-indigo-500",
+    icon: Code
+  },
+  {
+    extensions: ["twig", "jinja", "j2", "njk"],
+    mime: "text/x-twig",
+    category: "CODE",
+    subCategory: "TEMPLATE",
+    displayName: "Template",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-400",
+    icon: Code
+  },
+  {
+    extensions: ["hbs", "handlebars", "mustache", "ejs", "liquid"],
+    mime: "text/x-template",
+    category: "CODE",
+    subCategory: "TEMPLATE",
+    displayName: "Template",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: Code
+  },
+  // ────────────────────── DATA / CONFIG ──────────────────────
+  {
+    extensions: ["json", "jsonc", "json5", "har", "geojson", "topojson"],
+    aliases: [
+      ".babelrc",
+      ".eslintrc",
+      ".prettierrc",
+      ".stylelintrc",
+      ".swcrc",
+      ".huskyrc",
+      ".lintstagedrc"
+    ],
+    mime: "application/json",
+    category: "DATA",
+    subCategory: "JSON",
+    displayName: "JSON",
+    previewKind: "data",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: FileJson
+  },
+  {
+    extensions: ["yaml", "yml"],
+    aliases: [".yamllint", ".clang-format", ".clang-tidy"],
+    mime: "application/yaml",
+    category: "CODE",
+    subCategory: "YAML",
+    displayName: "YAML",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: Braces
+  },
+  {
+    extensions: ["toml"],
+    mime: "application/toml",
+    category: "CODE",
+    subCategory: "TOML",
+    displayName: "TOML",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: Braces
+  },
+  {
+    extensions: ["xml"],
+    mime: "application/xml",
+    category: "DATA",
+    subCategory: "XML",
+    displayName: "XML",
+    previewKind: "data",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: Braces
+  },
+  {
+    extensions: ["csv"],
+    mime: "text/csv",
+    category: "DATA",
+    subCategory: "CSV",
+    displayName: "CSV",
+    previewKind: "data",
+    thumbnailStrategy: "icon",
+    color: "text-orange-500",
+    icon: FileSpreadsheet
+  },
+  {
+    extensions: ["tsv"],
+    mime: "text/tab-separated-values",
+    category: "DATA",
+    subCategory: "TSV",
+    displayName: "TSV",
+    previewKind: "data",
+    thumbnailStrategy: "icon",
+    color: "text-orange-500",
+    icon: FileSpreadsheet
+  },
+  {
+    extensions: ["sqlite", "sqlite3", "db"],
+    mime: "application/x-sqlite3",
+    category: "DATA",
+    subCategory: "SQLITE",
+    displayName: "SQLite database",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-blue-400",
+    icon: Database
+  },
+  // PEM-encoded certs / CSRs are armored base64 — i.e. text. `.pem`
+  // and `.csr` are PEM by convention; `.crt` / `.cer` / `.key` / `.pub`
+  // can be either PEM or DER (binary), so they stay `generic` and the
+  // binary viewer's byte sniff offers "View as text" when the bytes
+  // turn out to be ASCII-armored.
+  {
+    extensions: ["pem", "csr"],
+    mime: "application/x-pem-file",
+    category: "CODE",
+    subCategory: "PEM",
+    displayName: "PEM certificate / key",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: FileText
+  },
+  {
+    extensions: ["crt", "cer", "der", "key", "pub", "p7b", "p7c", "pfx", "p12"],
+    mime: "application/x-x509-ca-cert",
+    category: "CODE",
+    subCategory: "CERT",
+    displayName: "Certificate",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-amber-500",
+    icon: FileText
+  },
+  // RDF / Turtle / N-Triples — text-based RDF data formats.
+  {
+    extensions: ["ttl", "n3", "nt", "nq", "trig"],
+    mime: "text/turtle",
+    category: "DATA",
+    subCategory: "RDF",
+    displayName: "RDF / Turtle",
+    previewKind: "code",
+    thumbnailStrategy: "icon",
+    color: "text-fuchsia-400",
+    icon: Braces
+  },
+  // ────────────────────── SPREADSHEET (Excel) ──────────────────────
+  {
+    extensions: ["xlsx"],
+    mime: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    category: "DOCUMENT",
+    subCategory: "EXCEL",
+    displayName: "Excel workbook",
+    previewKind: "spreadsheet",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-600",
+    icon: FileSpreadsheet,
+    previewSizeCapOverride: null
+  },
+  {
+    extensions: ["xls"],
+    mime: "application/vnd.ms-excel",
+    category: "DOCUMENT",
+    subCategory: "EXCEL",
+    displayName: "Excel workbook (legacy)",
+    previewKind: "spreadsheet",
+    thumbnailStrategy: "icon",
+    color: "text-emerald-600",
+    icon: FileSpreadsheet,
+    previewSizeCapOverride: null
+  },
+  // ────────────────────── OFFICE (Word / PowerPoint) ──────────────────────
+  // Server-side extraction preview: OfficePreview calls aidream
+  // `GET /office/{file_id}/markdown` (the matrx-files Office codec) and renders
+  // the document / deck as markdown, slide-by-slide for pptx. Legacy .doc/.ppt
+  // ride the server's LibreOffice bridge. xlsx stays on the SheetJS previewer.
+  {
+    extensions: ["doc", "docx"],
+    mime: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    category: "DOCUMENT",
+    subCategory: "WORD",
+    displayName: "Word document",
+    previewKind: "office",
+    thumbnailStrategy: "icon",
+    color: "text-blue-500",
+    icon: FileText
+    // No size cap needed: "office" is in the streamable-kind list of
+    // getFilePreviewProfile — bytes never reach the browser (server extracts).
+  },
+  {
+    extensions: ["ppt", "pptx"],
+    mime: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    category: "DOCUMENT",
+    subCategory: "POWERPOINT",
+    displayName: "PowerPoint",
+    previewKind: "office",
+    thumbnailStrategy: "icon",
+    color: "text-orange-600",
+    icon: FileType
+  },
+  // ────────────────────── NOTEBOOK ──────────────────────
+  // .ipynb is JSON under the hood, so it works in our DataPreview today.
+  // Eventually we'll ship a dedicated notebook renderer (cells + outputs).
+  {
+    extensions: ["ipynb"],
+    mime: "application/x-ipynb+json",
+    category: "NOTEBOOK",
+    subCategory: "JUPYTER",
+    displayName: "Jupyter notebook",
+    previewKind: "data",
+    thumbnailStrategy: "icon",
+    color: "text-orange-400",
+    icon: FileJson
+  },
+  // ────────────────────── EBOOK ──────────────────────
+  {
+    extensions: ["epub"],
+    mime: "application/epub+zip",
+    category: "EBOOK",
+    subCategory: "EPUB",
+    displayName: "EPUB ebook",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-indigo-500",
+    icon: FileText
+  },
+  // ────────────────────── EMAIL ──────────────────────
+  {
+    extensions: ["eml"],
+    mime: "message/rfc822",
+    category: "EMAIL",
+    subCategory: "EML",
+    displayName: "Email message",
+    previewKind: "text",
+    thumbnailStrategy: "icon",
+    color: "text-blue-400",
+    icon: FileText
+  },
+  // ────────────────────── 3D / CAD ──────────────────────
+  // No previewer yet (Three.js loader would be needed). Icons only.
+  {
+    extensions: ["glb", "gltf"],
+    mime: "model/gltf-binary",
+    category: "MODEL_3D",
+    subCategory: "GLTF",
+    displayName: "3D model (glTF)",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-violet-400",
+    icon: Package
+  },
+  {
+    extensions: ["stl", "obj", "fbx"],
+    mime: "model/stl",
+    category: "MODEL_3D",
+    subCategory: "MESH",
+    displayName: "3D mesh",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-violet-400",
+    icon: Package
+  },
+  // ────────────────────── ARCHIVES ──────────────────────
+  {
+    extensions: ["zip"],
+    mime: "application/zip",
+    category: "ARCHIVE",
+    subCategory: "ZIP",
+    displayName: "ZIP archive",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-amber-600",
+    icon: Archive
+  },
+  {
+    extensions: ["rar"],
+    mime: "application/vnd.rar",
+    category: "ARCHIVE",
+    subCategory: "RAR",
+    displayName: "RAR archive",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-amber-600",
+    icon: Archive
+  },
+  {
+    extensions: ["7z"],
+    mime: "application/x-7z-compressed",
+    category: "ARCHIVE",
+    subCategory: "7Z",
+    displayName: "7-Zip archive",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-amber-600",
+    icon: Archive
+  },
+  {
+    extensions: ["tar"],
+    mime: "application/x-tar",
+    category: "ARCHIVE",
+    subCategory: "TAR",
+    displayName: "TAR archive",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-amber-600",
+    icon: Package
+  },
+  {
+    extensions: ["gz", "tgz"],
+    mime: "application/gzip",
+    category: "ARCHIVE",
+    subCategory: "GZ",
+    displayName: "Gzip archive",
+    previewKind: "generic",
+    thumbnailStrategy: "icon",
+    color: "text-amber-600",
+    icon: Package
+  }
+];
+const UNKNOWN_DETAILS = {
+  category: "UNKNOWN",
+  subCategory: "UNKNOWN",
+  displayName: "File",
+  previewKind: "generic",
+  thumbnailStrategy: "icon",
+  color: "text-muted-foreground",
+  icon: FileIcon,
+  canPreview: false,
+  previewSizeCapOverride: null,
+  mime: "application/octet-stream"
+};
+const ASSUMED_TEXT_DETAILS = {
+  category: "DOCUMENT",
+  subCategory: "PLAIN",
+  displayName: "Text",
+  previewKind: "text",
+  thumbnailStrategy: "icon",
+  color: "text-muted-foreground",
+  icon: FileText,
+  canPreview: true,
+  previewSizeCapOverride: null,
+  mime: "text/plain"
+};
+const FOLDER_DETAILS = {
+  category: "FOLDER",
+  subCategory: "FOLDER",
+  displayName: "Folder",
+  previewKind: "generic",
+  thumbnailStrategy: "icon",
+  color: "text-sky-500",
+  icon: Folder,
+  canPreview: false,
+  previewSizeCapOverride: null,
+  mime: "inode/directory"
+};
+const BY_EXTENSION = /* @__PURE__ */ new Map();
+const BY_MIME = /* @__PURE__ */ new Map();
+const BY_NAME_EXACT = /* @__PURE__ */ new Map();
+const BY_NAME_LOWER = /* @__PURE__ */ new Map();
+const NAME_PREFIX_RULES = [];
+for (const entry of FILE_TYPES) {
+  for (const ext of entry.extensions)
+    BY_EXTENSION.set(ext.toLowerCase(), entry);
+  if (!BY_MIME.has(entry.mime)) BY_MIME.set(entry.mime, entry);
+  if (entry.aliases) {
+    for (const alias of entry.aliases) {
+      BY_NAME_EXACT.set(alias, entry);
+      const lower = alias.toLowerCase();
+      if (!BY_NAME_LOWER.has(lower)) BY_NAME_LOWER.set(lower, entry);
+    }
+  }
+  if (entry.aliasPrefixes) {
+    for (const prefix of entry.aliasPrefixes) {
+      NAME_PREFIX_RULES.push({ prefix: prefix.toLowerCase(), entry });
+    }
+  }
+}
+NAME_PREFIX_RULES.sort((a, b) => b.prefix.length - a.prefix.length);
+function entryToDetails(entry) {
+  return {
+    category: entry.category,
+    subCategory: entry.subCategory,
+    displayName: entry.displayName,
+    previewKind: entry.previewKind,
+    thumbnailStrategy: entry.thumbnailStrategy,
+    color: entry.color,
+    icon: entry.icon,
+    canPreview: entry.previewKind !== "generic",
+    previewSizeCapOverride: entry.previewSizeCapOverride !== void 0 ? entry.previewSizeCapOverride : null,
+    mime: entry.mime
+  };
+}
+function extOf(filename) {
+  const i = filename.lastIndexOf(".");
+  if (i <= 0 || i === filename.length - 1) return "";
+  return filename.slice(i + 1).toLowerCase();
+}
+function basenameOf(filename) {
+  const slash = Math.max(filename.lastIndexOf("/"), filename.lastIndexOf("\\"));
+  return slash >= 0 ? filename.slice(slash + 1) : filename;
+}
+function resolveEntry(filename) {
+  const name = basenameOf(filename);
+  const exact = BY_NAME_EXACT.get(name);
+  if (exact) return exact;
+  const ci = BY_NAME_LOWER.get(name.toLowerCase());
+  if (ci) return ci;
+  const ext = extOf(name);
+  if (ext) {
+    const byExt = BY_EXTENSION.get(ext);
+    if (byExt) return byExt;
+  }
+  const lower = name.toLowerCase();
+  for (const rule of NAME_PREFIX_RULES) {
+    if (lower.startsWith(rule.prefix)) return rule.entry;
+  }
+  return null;
+}
+function dotfileLooksLikeText(filename) {
+  const name = basenameOf(filename);
+  if (!name.startsWith(".")) return false;
+  for (let i = 1; i < name.length; i++) {
+    const c = name.charCodeAt(i);
+    if (c >= 48 && c <= 57 || // 0-9
+    c >= 65 && c <= 90 || // A-Z
+    c >= 97 && c <= 122 || // a-z
+    c === 95 || // _
+    c === 45) {
+      return true;
+    }
+  }
+  return false;
+}
+function getFileTypeDetails(filename) {
+  const entry = resolveEntry(filename);
+  if (entry) return entryToDetails(entry);
+  if (dotfileLooksLikeText(filename)) return ASSUMED_TEXT_DETAILS;
+  return UNKNOWN_DETAILS;
+}
+function getAssumedTextDetails(filename) {
+  const entry = resolveEntry(filename);
+  if (entry) {
+    const details = entryToDetails(entry);
+    if (details.previewKind === "generic") {
+      return { ...details, previewKind: "text", canPreview: true };
+    }
+    if (details.previewKind === "html") {
+      return { ...details, previewKind: "text" };
+    }
+    return details;
+  }
+  return ASSUMED_TEXT_DETAILS;
+}
+function isLikelyTextFilename(filename) {
+  const entry = resolveEntry(filename);
+  if (entry) {
+    return entry.previewKind === "code" || entry.previewKind === "text" || entry.previewKind === "markdown" || entry.previewKind === "data" || // HTML and SVG are markup-under-the-hood. The binary viewer / sniffer
+    // should treat them as text so "View as text" works on edge cases.
+    entry.previewKind === "html" || entry.previewKind === "svg";
+  }
+  return dotfileLooksLikeText(filename);
+}
+function getFolderTypeDetails(open = false) {
+  return open ? { ...FOLDER_DETAILS, icon: FolderOpen } : FOLDER_DETAILS;
+}
+function canonicalMimeBase(raw) {
+  return raw.split(";")[0]?.trim().toLowerCase() ?? raw;
+}
+function mimeFromFilename(filename) {
+  const entry = resolveEntry(filename);
+  return entry ? entry.mime : "application/octet-stream";
+}
+function resolveMime(explicit, filename) {
+  if (explicit && explicit !== "application/octet-stream") {
+    return canonicalMimeBase(explicit);
+  }
+  return mimeFromFilename(filename);
+}
+function getFilePreviewProfile(fileName, mimeType, fileSize) {
+  const mime = resolveMime(mimeType, fileName);
+  const fromExt = getFileTypeDetails(fileName);
+  const mimeEntry = BY_MIME.get(mime);
+  let baseDetails = fromExt;
+  const genericXmlSvg = fromExt.previewKind === "svg" && (mime === "application/xml" || mime === "text/xml");
+  if (mimeEntry && !genericXmlSvg && (mimeEntry.category !== fromExt.category || mimeEntry.previewKind !== fromExt.previewKind)) {
+    baseDetails = entryToDetails(mimeEntry);
+  }
+  let kind = baseDetails.previewKind;
+  let thumb = baseDetails.thumbnailStrategy;
+  if (mime === "image/svg+xml" || genericXmlSvg) {
+    kind = "svg";
+    thumb = "image";
+  } else if (mime.startsWith("image/")) {
+    kind = "image";
+    thumb = "image";
+  } else if (mime.startsWith("video/")) {
+    kind = "video";
+    thumb = thumb === "icon" ? "video-poster" : thumb;
+  } else if (mime.startsWith("audio/")) {
+    kind = "audio";
+    thumb = "icon";
+    if (baseDetails.category === "VIDEO") {
+      const audioEntry = BY_MIME.get(mime);
+      if (audioEntry) baseDetails = entryToDetails(audioEntry);
+    }
+  } else if (mime === "application/pdf") {
+    kind = "pdf";
+  } else if (kind === "generic" && isTextMime(mime)) {
+    kind = "text";
+  }
+  const canPreviewKind = kind !== "generic";
+  const cap = baseDetails.previewSizeCapOverride ?? // Streamable kinds are always allowed regardless of size. SVG joins the
+  // group: even though it's text underneath, it streams as an image via
+  // its durable URL — never read into memory by the renderer. HTML joins
+  // too: the Rendered view drives a sandboxed iframe on the durable URL
+  // (no client-side blob read), and the Source view fetches the bytes
+  // through the standard blob path which has its own truncation.
+  (kind === "image" || kind === "svg" || kind === "html" || kind === "video" || kind === "audio" || kind === "pdf" || kind === "spreadsheet" || // Office previews are SERVER-extracted (the browser only receives
+  // markdown) — the file's own byte size is irrelevant to the client.
+  kind === "office" ? Number.POSITIVE_INFINITY : MAX_INLINE_PREVIEW_BYTES);
+  const sizeOk = fileSize == null || fileSize <= cap;
+  return {
+    details: { ...baseDetails, previewKind: kind, thumbnailStrategy: thumb },
+    previewKind: kind,
+    canPreview: canPreviewKind && sizeOk,
+    sizeOk,
+    effectiveSizeCap: cap,
+    thumbnailStrategy: thumb,
+    mime
+  };
+}
+function isTextMime(mime) {
+  if (mime.startsWith("text/")) return true;
+  return mime === "application/json" || mime === "application/xml" || mime === "application/yaml" || mime === "application/x-yaml" || mime === "application/toml" || mime === "application/sql" || mime === "application/x-subrip" || mime === "message/rfc822";
+}
+function isImageMime(mime) {
+  return mime.startsWith("image/");
+}
+function isBrowserRenderableImageMime(mime) {
+  return mime === "image/avif" || mime === "image/bmp" || mime === "image/gif" || mime === "image/jpeg" || mime === "image/png" || mime === "image/svg+xml" || mime === "image/webp";
+}
+function isVideoMime(mime) {
+  return mime.startsWith("video/");
+}
+function isAudioMime(mime) {
+  return mime.startsWith("audio/");
+}
+function isPdfMime(mime) {
+  return mime === "application/pdf";
+}
+function sniffTextBytes(bytes, sampleSize = 4096) {
+  if (bytes.length === 0) {
+    return { isText: true, confidence: "high", reason: "empty file" };
+  }
+  const sample = bytes.subarray(0, Math.min(sampleSize, bytes.length));
+  if (sample.length >= 3 && sample[0] === 239 && sample[1] === 187 && sample[2] === 191) {
+    return { isText: true, confidence: "high", reason: "UTF-8 BOM" };
+  }
+  if (sample.length >= 2 && (sample[0] === 255 && sample[1] === 254 || sample[0] === 254 && sample[1] === 255)) {
+    return { isText: true, confidence: "high", reason: "UTF-16 BOM" };
+  }
+  if (typeof TextDecoder !== "undefined") {
+    try {
+      new TextDecoder("utf-8", { fatal: true }).decode(sample);
+      return { isText: true, confidence: "high", reason: "valid UTF-8" };
+    } catch {
+    }
+  }
+  let printable = 0;
+  for (let i = 0; i < sample.length; i++) {
+    const b = sample[i];
+    if (b === 0) {
+      return { isText: false, confidence: "high", reason: "null byte" };
+    }
+    if (b === 9 || b === 10 || b === 13 || b >= 32 && b <= 126) {
+      printable++;
+    }
+  }
+  const ratio = printable / sample.length;
+  if (ratio >= 0.95) {
+    return {
+      isText: true,
+      confidence: "medium",
+      reason: `${Math.round(ratio * 100)}% printable`
+    };
+  }
+  return {
+    isText: false,
+    confidence: "low",
+    reason: `only ${Math.round(ratio * 100)}% printable`
+  };
+}
+function listSupportedTypes() {
+  return FILE_TYPES.map((e) => ({
+    extensions: e.extensions,
+    mime: e.mime,
+    category: e.category,
+    displayName: e.displayName,
+    previewKind: e.previewKind,
+    thumbnailStrategy: e.thumbnailStrategy,
+    canPreview: e.previewKind !== "generic"
+  }));
+}
+export {
+  FILE_TYPES,
+  MAX_INLINE_PREVIEW_BYTES,
+  getAssumedTextDetails,
+  getFilePreviewProfile,
+  getFileTypeDetails,
+  getFolderTypeDetails,
+  isAudioMime,
+  isBrowserRenderableImageMime,
+  isImageMime,
+  isLikelyTextFilename,
+  isPdfMime,
+  isTextMime,
+  isVideoMime,
+  listSupportedTypes,
+  mimeFromFilename,
+  resolveMime,
+  sniffTextBytes
+};
+//# sourceMappingURL=file-types.js.map