lattice_core/ui/

icons.rs

//! Renderer-agnostic file-type icon resolver (DESIGN.md §5.6.7).
//!
//! Returns a glyph + renderer-neutral [`IconColor`] for any file or
//! directory path. The glyph is plain text -- the `lattice-file-tree`
//! render path embeds it directly in the rope so the model stays
//! usable from any renderer. The colour is mapped to the renderer's
//! native style at draw time (ratatui `Color`, GPUI `Hsla`, etc.).
//!
//! Two glyph palettes, picked by the `nerd_fonts` argument:
//!
//! - `nerd_fonts == true` -- Nerd Fonts v3 glyphs (Private Use Area
//!   codepoints, require a patched font installed in the terminal).
//! - `nerd_fonts == false` -- BMP-block fallback (Geometric Shapes,
//!   Misc Symbols). These render in any modern monospace font --
//!   DejaVu, JetBrains Mono, Fira, Cascadia, Consolas -- without
//!   needing a special install. Same six-bucket categorisation
//!   colour-tinted by language so a `.rs` and a `.py` still look
//!   different at a glance.
//!
//! Resolution order: exact filename → extension → default.

use std::path::Path;

/// Renderer-neutral colour. Concrete renderers (ratatui, GPUI, ...)
/// map the named variants to their own palette and `Rgb` straight
/// through.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum IconColor {
    /// Truecolor RGB packed as `0xRRGGBB`.
    Rgb(u32),
    /// "default foreground" -- the renderer uses its current style.
    Reset,
    /// Named yellow; each renderer maps it to its own palette.
    Yellow,
    /// Named dark grey; each renderer maps it to its own palette.
    DarkGray,
    /// The renderer's named blue.
    Blue,
    /// The renderer's named cyan.
    Cyan,
    /// The renderer's named green.
    Green,
    /// The renderer's named white.
    White,
}

/// Resolve `(glyph, colour)` for a directory or file entry.
///
/// `is_dir` selects the directory branch (folder glyph regardless
/// of name); for files the lookup falls through name → extension →
/// default. `nerd_fonts == false` returns a BMP-block fallback
/// glyph (◆ ≡ ◇ ■ ♪ ▶ · -- one per file family) with the colour
/// still resolved per type.
///
/// **Directories in BMP-fallback mode get `▤ `** (U+25A4, Geometric
/// Shapes -- present in every modern monospace font, and a drawer
/// of files is what it reads as).
///
/// This returned two blank spaces until 2026-08-16. The reasoning
/// was that the file tree already emits `▾ ` / `▸ ` as its
/// expansion-state marker, so a folder glyph would be redundant --
/// and that the one BMP glyph that obviously reads as "folder" is
/// the same right-pointing triangle `▸`, which would render a
/// collapsed row as `▸ ▸ name`, two identical arrows back to back.
///
/// Both points are true of the TREE and neither is true of **oil**,
/// whose rows are bare filenames with no marker at all (its
/// `icon_byte` is 0). So in BMP mode -- the DEFAULT, since
/// `ui.nerd_fonts` is opt-in -- an oil directory was the only entry
/// in the listing with no glyph, while every file had one. The
/// collision constraint is real; the conclusion "therefore nothing"
/// was drawn from the tree alone and applied to both.
///
/// `▤` satisfies the constraint properly: it collides with neither
/// expansion marker nor any file-family glyph, so the tree reads
/// `▸ ▤ name` -- state + kind + name, the nvim-tree / VS Code
/// convention -- and oil reads `▤ name`. Two cells wide like every
/// file glyph, so the name column never shifts between row kinds.
///
/// Nerd-fonts mode keeps the distinct folder glyph (`󰉋 ` is a
/// private-use codepoint that doesn't collide with the
/// geometric-shape marker), so directories there read as
/// `▸ 󰉋 name` -- marker + folder picto + name -- which is the
/// convention nvim-tree and VS Code follow.
/// **DL.6: the colour half has no consumers left.** `directory-listing-mode`
/// resolves entry colour through registered `listing.*` theme elements
/// now, so a theme owns the palette; this table's `IconColor` is only
/// still reachable because the glyph and the colour are produced by the
/// same ~200-arm match and splitting them is churn without a user-visible
/// win. New callers want [`glyph_for_entry`] plus a theme element — not
/// this.
pub fn entry_visual(path: &Path, is_dir: bool, nerd_fonts: bool) -> (&'static str, IconColor) {
    if is_dir {
        if nerd_fonts {
            return ("󰉋 ", IconColor::Blue);
        }
        // BMP fallback: a drawer, not blank padding. Collides with
        // neither the tree's `▸`/`▾` marker nor any file-family
        // glyph, and stays 2 cells so the name column is stable.
        return ("▤ ", IconColor::Blue);
    }
    let name = path.file_name().and_then(|n| n.to_str()).unwrap_or("");
    let ext = path.extension().and_then(|e| e.to_str()).unwrap_or("");
    if nerd_fonts {
        nerd_glyph_and_color(name, ext)
    } else {
        (ascii_glyph(name, ext), ext_color(name, ext))
    }
}

/// BMP-block fallback glyph for a file by name + extension. One of
/// six family buckets (config, document, image, archive, audio/video,
/// executable) plus a default middle-dot for source code and
/// everything else. All glyphs are 2 cells wide (one BMP char + a
/// trailing space) so they align with the nerd-font palette.
fn ascii_glyph(name: &str, ext: &str) -> &'static str {
    // Filenames that read as a manifest/build/config first, no
    // matter what extension they nominally carry. Mirrors the
    // explicit-name branch in `nerd_glyph_and_color` so the two
    // palettes stay in lockstep.
    match name {
        "Cargo.toml"
        | "Cargo.lock"
        | "package.json"
        | "package-lock.json"
        | "tsconfig.json"
        | "tsconfig.base.json"
        | "tsconfig.build.json"
        | "jsconfig.json"
        | "pyproject.toml"
        | "Pipfile"
        | "Pipfile.lock"
        | "setup.py"
        | "setup.cfg"
        | "requirements.txt"
        | "requirements-dev.txt"
        | "requirements-test.txt"
        | "Gemfile"
        | "Gemfile.lock"
        | "Rakefile"
        | "go.mod"
        | "go.sum"
        | "go.work"
        | "Brewfile"
        | "Brewfile.lock.json"
        | "Justfile"
        | "justfile"
        | "Makefile"
        | "makefile"
        | "GNUmakefile"
        | "BSDmakefile"
        | "Makefile.am"
        | "CMakeLists.txt"
        | "Dockerfile"
        | "dockerfile"
        | "Containerfile"
        | "containerfile"
        | "docker-compose.yml"
        | "docker-compose.yaml"
        | "compose.yml"
        | "compose.yaml"
        | ".dockerignore"
        | ".gitignore"
        | ".gitattributes"
        | ".gitmodules"
        | ".gitconfig"
        | ".gitmessage"
        | ".editorconfig"
        | ".env"
        | ".envrc"
        | ".npmrc"
        | ".nvmrc"
        | ".node-version"
        | ".eslintrc"
        | ".eslintrc.json"
        | ".eslintrc.js"
        | ".eslintrc.yml"
        | ".eslintrc.cjs"
        | ".prettierrc"
        | ".prettierrc.json"
        | ".prettierrc.js"
        | ".prettierrc.yml"
        | "Procfile"
        | "MANIFEST.in"
        | "uv.lock" => return "◆ ",
        "LICENSE" | "LICENCE" | "LICENSE.txt" | "LICENCE.txt" | "LICENSE.md" | "LICENCE.md" => {
            return "≡ ";
        }
        _ => {}
    }
    match ext {
        // Config / manifest
        "toml" | "yaml" | "yml" | "json" | "jsonc" | "json5" | "ini" | "cfg" | "conf"
        | "config" | "properties" | "prop" | "rc" | "env" | "envrc" | "dotenv" | "tf"
        | "tfvars" | "hcl" | "nix" | "lock" => "◆ ",
        // Document / prose
        "md" | "mdx" | "markdown" | "rst" | "txt" | "text" | "adoc" | "asciidoc" | "org"
        | "man" | "roff" | "groff" | "pdf" | "doc" | "docx" | "odt" | "rtf" | "xls" | "xlsx"
        | "ods" | "numbers" | "ppt" | "pptx" | "odp" | "keynote" | "tex" | "ltx" | "sty"
        | "bib" | "cls" | "ipynb" | "csv" | "tsv" => "≡ ",
        // Image / vector
        "png" | "jpg" | "jpeg" | "gif" | "bmp" | "webp" | "tiff" | "tif" | "ico" | "svg"
        | "svgz" | "heic" | "heif" | "avif" | "psd" | "xcf" | "ai" | "eps" | "sketch" | "fig"
        | "figma" => "◇ ",
        // Archive / packaged binary
        "zip" | "tar" | "gz" | "tgz" | "bz2" | "xz" | "zst" | "lz4" | "7z" | "rar" | "iso"
        | "cab" | "deb" | "rpm" | "pkg" | "apk" | "snap" => "■ ",
        // Audio + video share the music-note marker -- they read
        // as "media" in this fallback palette.
        "mp3" | "ogg" | "flac" | "wav" | "m4a" | "aac" | "wma" | "opus" | "aiff" | "mp4"
        | "mkv" | "avi" | "mov" | "wmv" | "flv" | "webm" | "m4v" | "ogv" => "♪ ",
        // Executable / installable
        "exe" | "msi" | "app" => "▶ ",
        // Source code, dotfiles, and anything not categorised
        // above. Colour still discriminates language thanks to
        // `ext_color`.
        _ => "· ",
    }
}

/// Glyph-only resolver. Used by the file-tree / oil rope renderers
/// that embed the glyph in editable text and let the renderer apply
/// styling spans. Equivalent to the first half of `entry_visual`.
pub fn glyph_for_entry(path: &Path, is_dir: bool, nerd_fonts: bool) -> &'static str {
    entry_visual(path, is_dir, nerd_fonts).0
}

fn nerd_glyph_and_color(name: &str, ext: &str) -> (&'static str, IconColor) {
    match name {
        "Makefile" | "makefile" | "GNUmakefile" | "BSDmakefile" | "Makefile.am" => {
            return (" ", IconColor::Rgb(0x6D8086));
        }
        "CMakeLists.txt" => return (" ", IconColor::Rgb(0x6D8086)),
        "Dockerfile" | "dockerfile" | "Containerfile" | "containerfile" => {
            return ("󰡨 ", IconColor::Rgb(0x458EE6));
        }
        "docker-compose.yml" | "docker-compose.yaml" | "compose.yml" | "compose.yaml" => {
            return ("󰡨 ", IconColor::Rgb(0x458EE6));
        }
        ".dockerignore" => return ("󰡨 ", IconColor::DarkGray),
        ".gitignore" | ".gitattributes" | ".gitmodules" | ".gitconfig" | ".gitmessage" => {
            return ("󰒓 ", IconColor::Rgb(0x41535B));
        }
        "LICENSE" | "LICENCE" | "LICENSE.txt" | "LICENCE.txt" | "LICENSE.md" | "LICENCE.md" => {
            return (" ", IconColor::Yellow);
        }
        ".editorconfig" => return (" ", IconColor::DarkGray),
        ".env" | ".envrc" => return (" ", IconColor::Rgb(0xFAF743)),
        "package.json" => return (" ", IconColor::Rgb(0xE8274B)),
        "package-lock.json" => return (" ", IconColor::DarkGray),
        ".npmrc" | ".nvmrc" | ".node-version" => return (" ", IconColor::Rgb(0xE8274B)),
        "tsconfig.json" | "tsconfig.base.json" | "tsconfig.build.json" => {
            return (" ", IconColor::Rgb(0x519ABA));
        }
        "jsconfig.json" => return (" ", IconColor::Rgb(0xCBCB41)),
        ".eslintrc" | ".eslintrc.json" | ".eslintrc.js" | ".eslintrc.yml" | ".eslintrc.cjs" => {
            return (" ", IconColor::Rgb(0x4B32C3));
        }
        ".prettierrc" | ".prettierrc.json" | ".prettierrc.js" | ".prettierrc.yml" => {
            return (" ", IconColor::Rgb(0x56B3B4));
        }
        "vite.config.ts" | "vite.config.js" => return (" ", IconColor::Rgb(0xBD34FE)),
        "vitest.config.ts" | "vitest.config.js" => return (" ", IconColor::Rgb(0xBD34FE)),
        "webpack.config.js" | "webpack.config.ts" => return ("󰜫 ", IconColor::Rgb(0x519ABA)),
        "next.config.js" | "next.config.ts" | "next.config.mjs" => {
            return (" ", IconColor::White);
        }
        "nuxt.config.ts" | "nuxt.config.js" => return (" ", IconColor::Rgb(0x00C58E)),
        "svelte.config.js" | "svelte.config.ts" => return (" ", IconColor::Rgb(0xFF3E00)),
        "astro.config.mjs" | "astro.config.ts" => return (" ", IconColor::Rgb(0xE8274B)),
        "tailwind.config.js" | "tailwind.config.ts" | "tailwind.config.cjs" => {
            return (" ", IconColor::Rgb(0x38BDF8));
        }
        "postcss.config.js" | "postcss.config.cjs" => return (" ", IconColor::DarkGray),
        "requirements.txt" | "requirements-dev.txt" | "requirements-test.txt" => {
            return (" ", IconColor::Rgb(0xFFBC03));
        }
        "Pipfile" | "Pipfile.lock" => return (" ", IconColor::Rgb(0xFFBC03)),
        "pyproject.toml" => return (" ", IconColor::Rgb(0xFFBC03)),
        "setup.py" | "setup.cfg" | "MANIFEST.in" => return (" ", IconColor::Rgb(0xFFBC03)),
        "uv.lock" => return (" ", IconColor::Rgb(0xDE5FE9)),
        "Gemfile" | "Gemfile.lock" => return (" ", IconColor::Rgb(0xFF5252)),
        "Rakefile" => return (" ", IconColor::Rgb(0xFF5252)),
        "go.mod" | "go.sum" | "go.work" => return (" ", IconColor::Rgb(0x519ABA)),
        "Cargo.toml" | "Cargo.lock" => return ("󱘗 ", IconColor::Rgb(0xFF8C00)),
        "Brewfile" | "Brewfile.lock.json" => return (" ", IconColor::Rgb(0xFBB040)),
        "Justfile" | "justfile" => return (" ", IconColor::Rgb(0x6D8086)),
        "Procfile" => return (" ", IconColor::DarkGray),
        _ => {}
    }

    match ext {
        "rs" => ("󱘗 ", IconColor::Rgb(0xDEA584)),
        "c" | "h" => (" ", IconColor::Rgb(0xA8B9CC)),
        "cpp" | "cxx" | "cc" | "c++" | "hpp" | "hxx" | "hh" | "h++" => {
            (" ", IconColor::Rgb(0xF34B7D))
        }
        "cs" | "csx" => ("󰌛 ", IconColor::Rgb(0x596706)),
        "java" => (" ", IconColor::Rgb(0xCC3E44)),
        "kt" | "kts" => (" ", IconColor::Rgb(0x7F52FF)),
        "swift" => (" ", IconColor::Rgb(0xE37933)),
        "go" => (" ", IconColor::Rgb(0x519ABA)),
        "zig" => (" ", IconColor::Rgb(0xF7A41D)),
        "nim" | "nims" | "nimble" => (" ", IconColor::Rgb(0xF3D400)),
        "v" | "vv" => (" ", IconColor::Rgb(0x5D87BF)),
        "odin" => (" ", IconColor::Rgb(0x60AEEF)),
        "asm" | "s" | "S" | "nasm" => (" ", IconColor::DarkGray),

        "py" | "pyw" | "pyi" => (" ", IconColor::Rgb(0xFFBC03)),
        "rb" | "erb" | "gemspec" | "rake" => (" ", IconColor::Rgb(0xFF5252)),
        "php" | "php3" | "php4" | "php5" | "phtml" => (" ", IconColor::Rgb(0xA074C4)),
        "lua" => (" ", IconColor::Rgb(0x51A0CF)),
        "pl" | "pm" | "t" | "pod" => (" ", IconColor::Rgb(0x519ABA)),
        "r" | "rmd" | "rnw" | "rproj" => (" ", IconColor::Rgb(0x2266BA)),
        "jl" => (" ", IconColor::Rgb(0xA270BA)),
        "dart" => (" ", IconColor::Rgb(0x03589C)),
        "groovy" | "gvy" => (" ", IconColor::Rgb(0x4298B8)),
        "tcl" | "tk" => (" ", IconColor::DarkGray),

        "hs" | "lhs" => (" ", IconColor::Rgb(0xA074C4)),
        "ex" | "exs" | "heex" | "leex" => (" ", IconColor::Rgb(0xA074C4)),
        "erl" | "hrl" => (" ", IconColor::Rgb(0xB83998)),
        "clj" | "cljs" | "cljc" | "edn" => (" ", IconColor::Rgb(0x8DC149)),
        "scala" | "sbt" | "sc" => (" ", IconColor::Rgb(0xCC3E44)),
        "ml" | "mli" | "mll" | "mly" => (" ", IconColor::Rgb(0xE37933)),
        "fs" | "fsi" | "fsx" | "fsproj" => (" ", IconColor::Rgb(0x519ABA)),
        "elm" => (" ", IconColor::Rgb(0x1293D8)),
        "cr" => (" ", IconColor::DarkGray),
        "d" | "di" => (" ", IconColor::Rgb(0xB03931)),
        "purs" => (" ", IconColor::Rgb(0x14213D)),
        "rkt" | "rktl" | "rktd" => (" ", IconColor::Rgb(0x9F1D20)),
        "lisp" | "lsp" | "el" | "elc" => (" ", IconColor::Rgb(0x9B59B6)),
        "scm" | "ss" => (" ", IconColor::Rgb(0x9B59B6)),

        "sh" | "bash" | "zsh" | "ksh" | "csh" | "tcsh" => (" ", IconColor::Rgb(0x4D5A5E)),
        "fish" => (" ", IconColor::Rgb(0x4D5A5E)),
        "ps1" | "psm1" | "psd1" | "ps1xml" => ("󰨊 ", IconColor::Rgb(0x4273CA)),
        "bat" | "cmd" => (" ", IconColor::Rgb(0xC1F12E)),

        "html" | "htm" | "xhtml" | "shtml" => (" ", IconColor::Rgb(0xE44D26)),
        "css" => (" ", IconColor::Rgb(0x42A5F5)),
        "scss" | "sass" => (" ", IconColor::Rgb(0xF55385)),
        "less" => (" ", IconColor::Rgb(0x563D7C)),
        "js" | "mjs" | "cjs" => (" ", IconColor::Rgb(0xCBCB41)),
        "ts" => (" ", IconColor::Rgb(0x519ABA)),
        "tsx" => (" ", IconColor::Rgb(0x1354BF)),
        "jsx" => (" ", IconColor::Rgb(0x519ABA)),
        "vue" => (" ", IconColor::Rgb(0x8DC149)),
        "svelte" => (" ", IconColor::Rgb(0xFF3E00)),
        "astro" => (" ", IconColor::Rgb(0xE8274B)),
        "njk" => ("󰗀 ", IconColor::Rgb(0x1BA354)),
        "hbs" | "handlebars" | "mustache" => (" ", IconColor::Rgb(0xF7931E)),
        "ejs" => (" ", IconColor::Rgb(0xA91E50)),
        "pug" | "jade" => (" ", IconColor::Rgb(0xE44B23)),
        "coffee" | "litcoffee" => (" ", IconColor::Rgb(0xCBCB41)),
        "wasm" => (" ", IconColor::Rgb(0x5C4CDB)),
        "wat" => (" ", IconColor::Rgb(0x5C4CDB)),

        "json" | "jsonc" | "json5" => (" ", IconColor::Rgb(0xCBCB41)),
        "yaml" | "yml" => (" ", IconColor::Rgb(0x6D8086)),
        "toml" => (" ", IconColor::Rgb(0x9C4221)),
        "xml" | "xsl" | "xslt" | "xsd" | "dtd" | "rss" | "atom" | "plist" => {
            ("󰗀 ", IconColor::Rgb(0xE37933))
        }
        "ini" | "cfg" | "conf" | "config" | "properties" | "prop" | "rc" => {
            (" ", IconColor::Rgb(0x6D8086))
        }
        "env" | "envrc" | "dotenv" => (" ", IconColor::Rgb(0xFAF743)),
        "csv" | "tsv" => (" ", IconColor::Rgb(0x89E051)),

        "sql" | "mysql" | "pgsql" | "psql" | "plsql" | "hql" => (" ", IconColor::Rgb(0xDAD8D8)),
        "sqlite" | "sqlite3" | "db" => (" ", IconColor::Rgb(0x003B57)),
        "prisma" => (" ", IconColor::Rgb(0x5A67D8)),
        "graphql" | "gql" => (" ", IconColor::Rgb(0xE535AB)),

        "md" | "mdx" | "markdown" => ("󰍔 ", IconColor::White),
        "rst" => (" ", IconColor::White),
        "txt" | "text" => (" ", IconColor::White),
        "pdf" => (" ", IconColor::Rgb(0xB30B00)),
        "doc" | "docx" | "odt" | "rtf" => (" ", IconColor::Rgb(0x295394)),
        "xls" | "xlsx" | "ods" | "numbers" => (" ", IconColor::Rgb(0x217346)),
        "ppt" | "pptx" | "odp" | "keynote" => (" ", IconColor::Rgb(0xB7472A)),
        "tex" | "ltx" | "sty" | "bib" | "cls" => (" ", IconColor::DarkGray),
        "org" => (" ", IconColor::Rgb(0x77AA99)),
        "adoc" | "asciidoc" => (" ", IconColor::White),
        "man" | "roff" | "groff" => (" ", IconColor::DarkGray),
        "ipynb" => (" ", IconColor::Rgb(0xF37726)),

        "png" | "jpg" | "jpeg" | "gif" | "bmp" | "webp" | "tiff" | "tif" | "ico" | "psd"
        | "xcf" | "heic" | "heif" | "avif" => (" ", IconColor::Rgb(0xA074C4)),
        "svg" | "svgz" => ("󰜡 ", IconColor::Rgb(0xFFB13B)),
        "ai" | "eps" => (" ", IconColor::Rgb(0xFF7C00)),
        "sketch" | "fig" | "figma" => (" ", IconColor::Rgb(0xFDB300)),

        "mp4" | "mkv" | "avi" | "mov" | "wmv" | "flv" | "webm" | "m4v" | "ogv" => {
            (" ", IconColor::Rgb(0xFD971F))
        }
        "mp3" | "ogg" | "flac" | "wav" | "m4a" | "aac" | "wma" | "opus" | "aiff" => {
            ("󰎆 ", IconColor::Rgb(0x00AFFF))
        }

        "zip" | "tar" | "gz" | "tgz" | "bz2" | "xz" | "zst" | "lz4" | "7z" | "rar" | "cab"
        | "iso" => (" ", IconColor::Rgb(0xECA517)),
        "deb" | "rpm" | "pkg" | "apk" | "snap" => (" ", IconColor::Rgb(0xECA517)),

        "ttf" | "otf" | "woff" | "woff2" | "eot" => (" ", IconColor::Rgb(0xFFAFF3)),

        "pem" | "key" | "crt" | "cer" | "der" | "p12" | "pfx" | "p8" | "pub" => {
            ("󰌇 ", IconColor::Rgb(0xD4AF37))
        }
        "gpg" | "asc" | "sig" => ("󰌇 ", IconColor::Rgb(0xD4AF37)),

        "exe" | "msi" | "app" => (" ", IconColor::Rgb(0x9F0500)),
        "dll" | "so" | "dylib" | "lib" | "a" => (" ", IconColor::DarkGray),
        "o" | "obj" | "pyc" | "class" => (" ", IconColor::DarkGray),

        "patch" | "diff" => (" ", IconColor::Rgb(0x41535B)),

        "gitignore" | "gitmodules" | "gitattributes" | "gitconfig" => {
            ("󰒓 ", IconColor::Rgb(0x41535B))
        }

        "dockerfile" | "containerfile" => ("󰡨 ", IconColor::Rgb(0x458EE6)),
        "tf" | "tfvars" => (" ", IconColor::Rgb(0x844FBA)),
        "hcl" => (" ", IconColor::Rgb(0x844FBA)),
        "nix" => (" ", IconColor::Rgb(0x7EB7E4)),
        "proto" | "protobuf" => (" ", IconColor::Rgb(0x5BA4CF)),
        "thrift" => (" ", IconColor::DarkGray),
        "k8s" | "helm" => (" ", IconColor::Rgb(0x326CE5)),

        "mk" | "mak" => (" ", IconColor::Rgb(0x6D8086)),
        "cmake" => (" ", IconColor::Rgb(0x6D8086)),
        "bazel" | "bzl" => (" ", IconColor::Rgb(0x76D275)),
        "ninja" => (" ", IconColor::DarkGray),
        "gradle" => (" ", IconColor::Rgb(0x4298B8)),

        "vim" | "vimrc" | "nvimrc" => (" ", IconColor::Rgb(0x019833)),
        "lock" => ("󰌾 ", IconColor::DarkGray),
        "log" => (" ", IconColor::DarkGray),
        "pid" => (" ", IconColor::DarkGray),
        "tmp" | "temp" => (" ", IconColor::DarkGray),
        "bak" | "backup" | "old" => (" ", IconColor::DarkGray),
        "swp" | "swo" => (" ", IconColor::DarkGray),
        "mdump" | "dmp" => (" ", IconColor::DarkGray),

        _ => (" ", IconColor::Reset),
    }
}

fn ext_color(name: &str, ext: &str) -> IconColor {
    match name {
        "Makefile" | "makefile" | "CMakeLists.txt" => return IconColor::Rgb(0x6D8086),
        "Dockerfile" | "dockerfile" => return IconColor::Blue,
        ".gitignore" | ".gitattributes" | ".gitmodules" => return IconColor::DarkGray,
        "LICENSE" | "LICENCE" => return IconColor::Yellow,
        _ => {}
    }
    match ext {
        "rs" => IconColor::Rgb(0xDEA584),
        "c" | "h" | "cpp" | "cxx" | "hpp" => IconColor::Blue,
        "cs" | "java" | "scala" => IconColor::Rgb(0xCC3E44),
        "kt" | "kts" => IconColor::Rgb(0x7F52FF),
        "swift" => IconColor::Rgb(0xE37933),
        "go" => IconColor::Cyan,
        "zig" | "nim" => IconColor::Yellow,
        "py" | "pyw" | "pyi" => IconColor::Rgb(0xFFBC03),
        "rb" | "erb" => IconColor::Rgb(0xFF5252),
        "php" => IconColor::Rgb(0xA074C4),
        "lua" => IconColor::Blue,
        "r" | "jl" => IconColor::Blue,
        "dart" => IconColor::Cyan,
        "hs" | "lhs" => IconColor::Rgb(0xA074C4),
        "ex" | "exs" => IconColor::Rgb(0xA074C4),
        "erl" | "hrl" => IconColor::Rgb(0xB83998),
        "clj" | "cljs" => IconColor::Green,
        "js" | "mjs" | "cjs" | "coffee" => IconColor::Rgb(0xCBCB41),
        "ts" | "tsx" | "jsx" => IconColor::Blue,
        "html" | "htm" => IconColor::Rgb(0xE44D26),
        "css" | "less" => IconColor::Blue,
        "scss" | "sass" => IconColor::Rgb(0xF55385),
        "vue" | "svelte" => IconColor::Green,
        "toml" => IconColor::Yellow,
        "json" | "jsonc" | "json5" => IconColor::Yellow,
        "yaml" | "yml" => IconColor::Green,
        "xml" => IconColor::Rgb(0xE37933),
        "sh" | "bash" | "zsh" | "fish" => IconColor::Green,
        "ps1" | "psm1" => IconColor::Blue,
        "vim" | "vimrc" => IconColor::Green,
        "md" | "mdx" | "rst" | "txt" => IconColor::White,
        "sql" => IconColor::DarkGray,
        "graphql" | "gql" => IconColor::Rgb(0xE535AB),
        "tf" | "hcl" => IconColor::Rgb(0x844FBA),
        "nix" => IconColor::Blue,
        "prisma" => IconColor::Rgb(0x5A67D8),
        "lock" => IconColor::DarkGray,
        "log" => IconColor::DarkGray,
        "png" | "jpg" | "jpeg" | "gif" | "svg" | "bmp" | "webp" | "ico" => IconColor::Rgb(0xA074C4),
        "mp4" | "mkv" | "avi" | "mov" => IconColor::Rgb(0xFD971F),
        "mp3" | "flac" | "wav" | "ogg" => IconColor::Cyan,
        "zip" | "tar" | "gz" | "bz2" | "7z" | "rar" => IconColor::Rgb(0xECA517),
        "pdf" => IconColor::Rgb(0xB30B00),
        _ => IconColor::Reset,
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::path::PathBuf;

    #[test]
    fn directory_returns_dir_glyph() {
        let (glyph, _) = entry_visual(&PathBuf::from("src"), true, true);
        assert_eq!(glyph, "󰉋 ");
    }

    #[test]
    fn nerd_fonts_false_gives_directories_a_glyph_of_their_own() {
        // 2026-08-16: this used to assert two blank spaces. The
        // rationale was the file tree's `▸` / `▾` marker already
        // saying "directory" -- true of the TREE, and never true of
        // oil, whose rows are bare names with no marker at all. In
        // BMP mode an oil directory was therefore the one entry with
        // no glyph while every file had one.
        let (glyph, _) = entry_visual(&PathBuf::from("src"), true, false);
        assert_eq!(glyph, "▤ ");
    }

    /// The constraint that ruled out the obvious BMP folder glyph: `▸`
    /// is the tree's collapsed-directory marker, so reusing it would
    /// render `▸ ▸ name` -- two identical arrows back to back. Pin that
    /// the chosen glyph collides with neither marker nor any file
    /// family, since "it looks like something else" is the only way
    /// this choice can be wrong.
    #[test]
    fn the_bmp_directory_glyph_collides_with_nothing() {
        let dir = entry_visual(&PathBuf::from("src"), true, false).0;

        for marker in ["▸ ", "▾ "] {
            assert_ne!(
                dir, marker,
                "must not duplicate the file-tree expansion marker"
            );
        }
        for family in ["· ", "≡ ", "■ ", "▶ ", "◆ ", "◇ ", "♪ "] {
            assert_ne!(dir, family, "must not read as a file family");
        }
        assert_eq!(
            dir.chars().count(),
            2,
            "same 2-cell width as every file glyph, so the name column \
             does not shift between file and directory rows"
        );
    }

    #[test]
    fn nerd_fonts_false_picks_glyph_by_file_family() {
        // Config family
        assert_eq!(
            entry_visual(&PathBuf::from("Cargo.toml"), false, false).0,
            "◆ "
        );
        assert_eq!(
            entry_visual(&PathBuf::from("config.yaml"), false, false).0,
            "◆ "
        );
        // Document family
        assert_eq!(
            entry_visual(&PathBuf::from("README.md"), false, false).0,
            "≡ "
        );
        assert_eq!(
            entry_visual(&PathBuf::from("LICENSE"), false, false).0,
            "≡ "
        );
        // Image family
        assert_eq!(
            entry_visual(&PathBuf::from("logo.png"), false, false).0,
            "◇ "
        );
        // Archive family
        assert_eq!(
            entry_visual(&PathBuf::from("dist.zip"), false, false).0,
            "■ "
        );
        // Media family
        assert_eq!(
            entry_visual(&PathBuf::from("song.mp3"), false, false).0,
            "♪ "
        );
        assert_eq!(
            entry_visual(&PathBuf::from("clip.mp4"), false, false).0,
            "♪ "
        );
        // Source code + everything else → middle dot
        assert_eq!(
            entry_visual(&PathBuf::from("main.rs"), false, false).0,
            "· "
        );
        assert_eq!(
            entry_visual(&PathBuf::from("script.py"), false, false).0,
            "· "
        );
        assert_eq!(
            entry_visual(&PathBuf::from(".gitignore"), false, false).0,
            "◆ "
        );
    }

    #[test]
    fn rust_file_gets_orange_rgb() {
        let (glyph, color) = entry_visual(&PathBuf::from("main.rs"), false, true);
        assert_eq!(glyph, "󱘗 ");
        assert_eq!(color, IconColor::Rgb(0xDEA584));
    }

    #[test]
    fn unknown_ext_falls_back_to_default_glyph() {
        let (glyph, _) = entry_visual(&PathBuf::from("binary.bin"), false, true);
        assert_eq!(glyph, " ");
    }

    #[test]
    fn dockerfile_exact_name_match() {
        let (glyph, color) = entry_visual(&PathBuf::from("Dockerfile"), false, true);
        assert_eq!(glyph, "󰡨 ");
        assert_eq!(color, IconColor::Rgb(0x458EE6));
    }

    #[test]
    fn glyph_only_helper_matches_visual_first_field() {
        let path = PathBuf::from("App.tsx");
        let g = glyph_for_entry(&path, false, true);
        let (g2, _) = entry_visual(&path, false, true);
        assert_eq!(g, g2);
    }
}