@suzumiyaaoba/mdxr 0.1.0

package/src/ui/file-icon.ts

@@ -0,0 +1,1020 @@
+import { own } from "../guards.js";
+import { hasIcon } from "./icon.js";
+
+/**
+ * Maps file paths and directory names to Iconify icons. Uses the bundled
+ * `vscode-icons` set (`file-type-*`, `folder-type-*`, `default-*`) so common
+ * files get their brand icon. Values in the tables are `file-type-*` keys —
+ * or full `prefix:name` iconify names for the rare picks outside the set.
+ */
+
+const fileType = (key: string): string =>
+  key.includes(":") ? key : `vscode-icons:file-type-${key}`;
+const folderType = (key: string): string => `vscode-icons:folder-type-${key}`;
+
+const DEFAULT_FILE = "vscode-icons:default-file";
+const DEFAULT_FOLDER = "vscode-icons:default-folder";
+
+/** Exact basenames (lowercased) → icon key. Beats patterns and extensions. */
+const FILE_NAMES: Record<string, string> = {
+  ".angular-cli.json": "angular",
+  ".appveyor.yml": "appveyor",
+  ".babelrc": "babel",
+  ".bazelignore": "bazel",
+  ".bazelrc": "bazel",
+  ".bazelversion": "bazel",
+  ".browserslistrc": "browserslist",
+  ".bunignore": "bun",
+  ".clippy.toml": "rust",
+  ".codacy.yml": "codacy",
+  ".codeclimate.yml": "codeclimate",
+  ".codecov.yml": "codecov",
+  ".condarc": "conda",
+  ".coveragerc": "python",
+  ".cursorignore": "cursorrules",
+  ".cursorrules": "cursorrules",
+  ".deepsource.toml": "deepsource",
+  ".devcontainer.json": "devcontainer",
+  ".direnvrc": "direnv",
+  ".dockerignore": "docker",
+  ".drone.yml": "drone",
+  ".editorconfig": "editorconfig",
+  ".envrc": "direnv",
+  ".eslintignore": "eslint",
+  ".eslintrc": "eslint",
+  ".firebaserc": "firebase",
+  ".flake8": "python",
+  ".git-blame-ignore-revs": "git",
+  ".gitattributes": "git",
+  ".gitconfig": "git",
+  ".gitignore": "git",
+  ".gitkeep": "git",
+  ".gitlab-ci.yml": "gitlab",
+  ".gitmodules": "git",
+  ".htaccess": "apache",
+  ".htpasswd": "apache",
+  ".huskyrc": "husky",
+  ".huskyrc.json": "husky",
+  ".ionicrc": "ionic",
+  ".justfile": "just",
+  ".mailmap": "git",
+  ".mise.toml": "mise",
+  ".netlifyignore": "netlify",
+  ".node-version": "node",
+  ".npmignore": "npm",
+  ".npmrc": "npm",
+  ".nvmrc": "node",
+  ".pnp.cjs": "yarn",
+  ".pnp.loader.mjs": "yarn",
+  ".pnpmfile.cjs": "pnpm",
+  ".prettierignore": "prettier",
+  ".prettierrc": "prettier",
+  ".pylintrc": "python",
+  ".python-version": "python",
+  ".renovaterc": "renovate",
+  ".ruby-version": "ruby",
+  ".rustfmt.toml": "rust",
+  ".stylelintignore": "stylelint",
+  ".stylelintrc": "stylelint",
+  ".swcrc": "swc",
+  ".terraform.lock.hcl": "terraform",
+  ".tool-versions": "mise",
+  ".travis.yml": "travis",
+  ".vercelignore": "vercel",
+  ".vscodeignore": "vscode",
+  ".yarnrc": "yarn",
+  ".yarnrc.yaml": "yarn",
+  ".yarnrc.yml": "yarn",
+  "agents.md": "agents",
+  "angular-cli.json": "angular",
+  "angular.json": "angular",
+  "ansible.cfg": "ansible",
+  "app.yaml": "gcloud",
+  "app.yml": "gcloud",
+  "appveyor.yml": "appveyor",
+  authorized_keys: "key",
+  authors: "text",
+  "azure-pipelines.yaml": "azurepipelines",
+  "azure-pipelines.yml": "azurepipelines",
+  berksfile: "chef",
+  "biome.json": "biome",
+  "biome.jsonc": "biome",
+  "bitbucket-pipelines.yml": "bitbucketpipeline",
+  brewfile: "brew",
+  browserslist: "browserslist",
+  "build.bazel": "bazel",
+  "bun.lock": "bun",
+  "bun.lockb": "bun",
+  "bunfig.toml": "bunfig",
+  "cabal.project": "cabal",
+  caddyfile: "caddy",
+  "cargo.lock": "cargo",
+  "cargo.toml": "cargo",
+  changelog: "text",
+  changes: "text",
+  "chart.yaml": "helm",
+  cheffile: "chef",
+  "circle.yml": "circleci",
+  "claude.md": "claude",
+  "clippy.toml": "rust",
+  "cloudbuild.yaml": "gcloud",
+  "cloudbuild.yml": "gcloud",
+  "cmakelists.txt": "cmake",
+  "codacy.yml": "codacy",
+  code_of_conduct: "text",
+  "codeclimate.yml": "codeclimate",
+  "codecov.yaml": "codecov",
+  "codecov.yml": "codecov",
+  codeowners: "codeowners",
+  "compose.yaml": "docker",
+  "compose.yml": "docker",
+  "composer.json": "composer",
+  "composer.lock": "composer",
+  "conda.yaml": "conda",
+  "conda.yml": "conda",
+  "constraints.txt": "python",
+  containerfile: "docker",
+  contributing: "text",
+  contributors: "text",
+  "copilot-instructions.md": "copilot",
+  copying: "license",
+  "crowdin.yaml": "crowdin",
+  "crowdin.yml": "crowdin",
+  "database.rules.json": "firebase",
+  "default.nix": "nix",
+  "deno.json": "deno",
+  "deno.jsonc": "deno",
+  "deno.lock": "deno",
+  "dependabot.yml": "dependabot",
+  "devcontainer.json": "devcontainer",
+  "devenv.lock": "devenv",
+  "devenv.nix": "devenv",
+  "devenv.yaml": "devenv",
+  direnvrc: "direnv",
+  "docker-compose.yaml": "docker",
+  "docker-compose.yml": "docker",
+  dockerfile: "docker",
+  "drone.yml": "drone",
+  dune: "dune",
+  "dune-project": "dune",
+  "dune-workspace": "dune",
+  "environment.yaml": "conda",
+  "environment.yml": "conda",
+  "erlang.mk": "erlang",
+  "firebase.json": "firebase",
+  "firestore.indexes.json": "firestore",
+  "firestore.rules": "firestore",
+  "flake.lock": "nix",
+  "flake.nix": "nix",
+  "fly.toml": "flyio",
+  "funding.yml": "funding",
+  gemfile: "bundler",
+  "gemfile.lock": "bundler",
+  "gemini.md": "gemini",
+  gnumakefile: "gnu",
+  "go.mod": "go-package",
+  "go.sum": "go-package",
+  "go.work": "go-work",
+  "go.work.sum": "go-work",
+  "gradle.properties": "gradle",
+  gradlew: "gradle",
+  "gradlew.bat": "gradle",
+  guardfile: "ruby",
+  "helmfile.yaml": "helm",
+  "helmfile.yml": "helm",
+  history: "text",
+  "humans.txt": "humanstxt",
+  id_dsa: "key",
+  id_ecdsa: "key",
+  id_ed25519: "key",
+  id_rsa: "key",
+  "ionic.config.json": "ionic",
+  jenkinsfile: "jenkins",
+  "jsconfig.json": "jsconfig",
+  justfile: "just",
+  known_hosts: "key",
+  "lefthook.toml": "lefthook",
+  "lefthook.yaml": "lefthook",
+  "lefthook.yml": "lefthook",
+  "lerna.json": "lerna",
+  licence: "license",
+  license: "license",
+  maintainers: "text",
+  makefile: "gnu",
+  "manifest.json": "manifest",
+  "manifest.webmanifest": "manifest",
+  "meson.build": "meson",
+  "meson_options.txt": "meson",
+  "mise.toml": "mise",
+  "module.bazel": "bazel",
+  "module.bazel.lock": "bazel",
+  mvnw: "maven",
+  "mvnw.cmd": "maven",
+  "netlify.toml": "netlify",
+  news: "text",
+  "nginx.conf": "nginx",
+  notice: "license",
+  "now.json": "vercel",
+  "npm-shrinkwrap.json": "npm",
+  "nx.json": "nx",
+  "package-lock.json": "npm",
+  "package.json": "npm",
+  "package.yaml": "haskell",
+  patents: "license",
+  "pdm.lock": "python",
+  pipfile: "python",
+  "pipfile.lock": "python",
+  "pnpm-lock.yaml": "pnpm",
+  "pnpm-workspace.yaml": "pnpm",
+  podfile: "ruby",
+  "podfile.lock": "ruby",
+  "poetry.lock": "poetry",
+  "pom.xml": "maven",
+  pylintrc: "python",
+  "pyproject.toml": "python",
+  rakefile: "rake",
+  readme: "text",
+  "rebar.config": "erlang",
+  "rebar.lock": "erlang",
+  "renovate.json": "renovate",
+  "requirements.txt": "python",
+  "robots.txt": "robots",
+  "rust-toolchain": "rust-toolchain",
+  "rust-toolchain.toml": "rust-toolchain",
+  "rust-toolchain.yaml": "rust-toolchain",
+  "rustfmt.toml": "rust",
+  security: "text",
+  "serverless.yaml": "serverless",
+  "serverless.yml": "serverless",
+  "setup.cfg": "python",
+  "setup.py": "python",
+  "shell.nix": "nix",
+  "site.webmanifest": "manifest",
+  "stack.yaml": "haskell",
+  "storage.rules": "firebasestorage",
+  support: "text",
+  "tauri.conf.json": "tauri",
+  todo: "todo",
+  todos: "todo",
+  "tox.ini": "python",
+  "tsconfig.json": "tsconfig",
+  "turbo.json": "turbo",
+  "uv.lock": "uv",
+  vagrantfile: "vagrant",
+  "vercel.json": "vercel",
+  "web.config": "config",
+  "workspace.bazel": "bazel",
+  "wrangler.json": "cloudflare",
+  "wrangler.jsonc": "cloudflare",
+  "wrangler.toml": "cloudflare",
+  "yarn.lock": "yarn",
+};
+
+/** Basename patterns → icon key. First match wins. */
+const FILE_PATTERNS: readonly (readonly [RegExp, string])[] = [
+  [/\.d\.[cm]?ts$/u, "typescriptdef"],
+  [/\.blade\.php$/u, "blade"],
+  [/\.(?:test|spec)\.tsx?$/u, "testts"],
+  [/\.(?:test|spec)\.jsx?$/u, "testjs"],
+  [/_test\.go$/u, "go"],
+  [/\.(?:test|spec)\.\w+$/u, "test"],
+  [/_(?:test|spec)\.\w+$/u, "test"],
+  [/^test_.+\.py$/u, "python"],
+  [/\.stories?\.[jt]sx?$/u, "storybook"],
+  [/^tsconfig(?:\.[\w-]+)*\.json$/u, "tsconfig"],
+  [/^jsconfig(?:\.[\w-]+)*\.json$/u, "jsconfig"],
+  [/^\.?babelrc(?:\..+)?$/u, "babel"],
+  [/^\.?eslintrc(?:\..+)?$/u, "eslint"],
+  [/^\.?prettierrc(?:\..+)?$/u, "prettier"],
+  [/^\.?stylelintrc(?:\..+)?$/u, "stylelint"],
+  [/^\.?commitlintrc(?:\..+)?$/u, "commitlint"],
+  [/^\.?oxlintrc(?:\..+)?$/u, "oxc"],
+  [/^\.?oxfmtrc(?:\..+)?$/u, "oxc"],
+  [/^\.?oxcrc(?:\..+)?$/u, "oxc"],
+  [/^\.?cspell(?:rc)?(?:\..+)?$/u, "cspell"],
+  [/^\.?markdownlint(?:rc)?(?:\..+)?$/u, "markdownlint"],
+  [/^\.?htmlhintrc(?:\..+)?$/u, "htmlhint"],
+  [/^\.?jshintrc(?:\..+)?$/u, "jshint"],
+  [/^\.?lefthook(?:[-.].+)?$/u, "lefthook"],
+  [/^\.?renovate(?:rc)?(?:\..+)?$/u, "renovate"],
+  [/^\.?graphqlrc(?:\..+)?$/u, "graphql-config"],
+  [/^codegen(?:\..+)?$/u, "graphql-config"],
+  [/^\.?gitlab-ci.*\.ya?ml$/u, "gitlab"],
+  [/^azure-pipelines.*\.ya?ml$/u, "azurepipelines"],
+  [/^\.env(?:\..+)?$/u, "dotenv"],
+  [/^dockerfile(?:\..+)?$/u, "docker"],
+  [/\.dockerfile$/u, "docker"],
+  [/^containerfile(?:\..+)?$/u, "docker"],
+  [/^docker-compose(?:\..+)?\.ya?ml$/u, "docker"],
+  [/^compose(?:\..+)?\.ya?ml$/u, "docker"],
+  [/^requirements[._-]?.*\.txt$/u, "python"],
+  [/^licen[cs]e[._-]?(?:\..+)?$/u, "license"],
+  [/^sitemap.*\.xml$/u, "sitemap"],
+  [/\.vscodeignore$/u, "vscode"],
+  [/^wrangler\..+$/u, "cloudflare"],
+  [/\.gemspec$/u, "bundler"],
+  [/\.jenkinsfile$/u, "jenkins"],
+  [/^jenkinsfile\..+$/u, "jenkins"],
+  [/\.gradle\.kts$/u, "gradle"],
+  [/^gradlew(?:\..+)?$/u, "gradle"],
+  [/^tauri\..*\.conf\.json$/u, "tauri"],
+  [/^electron-builder(?:\..+)?$/u, "electron"],
+  [/^serverless\.(?:ts|js|json)$/u, "serverless"],
+  [/^\.mise[./]/u, "mise"],
+];
+
+/** `<tool>.config.<ext>` → icon key (unknown tools fall back to `config`). */
+const CONFIG_TOOLS: Record<string, string> = {
+  astro: "astroconfig",
+  babel: "babel",
+  capacitor: "capacitor",
+  commitlint: "commitlint",
+  cypress: "cypress",
+  drizzle: "drizzle-orm",
+  electron: "electron",
+  esbuild: "esbuild",
+  eslint: "eslint",
+  jest: "jest",
+  karma: "karma",
+  knip: "knip",
+  lefthook: "lefthook",
+  next: "next",
+  nuxt: "nuxt",
+  oxc: "oxc",
+  oxfmt: "oxc",
+  oxlint: "oxc",
+  parcel: "parcel",
+  playwright: "playwright",
+  postcss: "postcss",
+  prettier: "prettier",
+  rolldown: "rolldown",
+  rollup: "rollup",
+  storybook: "storybook",
+  stylelint: "stylelint",
+  svelte: "svelte",
+  tailwind: "tailwind",
+  tauri: "tauri",
+  typedoc: "typedoc",
+  vite: "vite",
+  vitest: "vitest",
+  vue: "vue",
+  webpack: "webpack",
+};
+
+const CONFIG_RE = /^(?<tool>[a-z0-9][a-z0-9-]*)\.config\.[cm]?[jt]sx?$/u;
+
+/** Extensions (lowercase, no dot) → icon key. Also covers bare shiki lang ids. */
+const EXT_ICONS: Record<string, string> = {
+  "3gp": "video",
+  "7z": "zip",
+  a: "binary",
+  aab: "binary",
+  aac: "audio",
+  ada: "ada",
+  adb: "ada",
+  adoc: "asciidoc",
+  ads: "ada",
+  ahk: "autohotkey",
+  ai: "ai",
+  am: "gnu",
+  ansible: "ansible",
+  apache: "apache",
+  apk: "binary",
+  appimage: "binary",
+  applescript: "applescript",
+  asc: "gpg",
+  asciidoc: "asciidoc",
+  asm: "assembly",
+  asp: "asp",
+  aspx: "aspx",
+  ass: "text",
+  astro: "astro",
+  au3: "autoit",
+  avi: "video",
+  avif: "avif",
+  avro: "avro",
+  awk: "awk",
+  azw3: "epub",
+  bas: "vb",
+  bash: "shell",
+  bat: "bat",
+  bazel: "bazel",
+  bib: "tex",
+  bicep: "bicep",
+  bin: "binary",
+  bmp: "image",
+  bru: "bruno",
+  bz2: "zip",
+  bzl: "bazel",
+  c: "c",
+  "c#": "csharp",
+  "c++": "cpp",
+  cab: "zip",
+  cabal: "cabal",
+  caddy: "caddy",
+  capnp: "capnp",
+  cbl: "cobol",
+  cc: "cpp",
+  cer: "cert",
+  cfg: "config",
+  cjs: "js",
+  class: "class",
+  clj: "clojure",
+  cljc: "clojure",
+  cljs: "clojurescript",
+  clojure: "clojure",
+  cls: "tex",
+  cmake: "cmake",
+  cmd: "bat",
+  cob: "cobol",
+  cobol: "cobol",
+  com: "binary",
+  conf: "config",
+  config: "config",
+  console: "shell",
+  cp: "cpp",
+  cpp: "cpp",
+  cr: "crystal",
+  crt: "cert",
+  crystal: "crystal",
+  cs: "csharp",
+  csharp: "csharp",
+  cshtml: "razor",
+  csproj: "csproj",
+  csr: "cert",
+  css: "css",
+  csv: "excel",
+  csx: "csharp",
+  cts: "typescript",
+  cur: "image",
+  cxx: "cpp",
+  dart: "dartlang",
+  dat: "binary",
+  db: "db",
+  db3: "db",
+  dbml: "dbml",
+  deb: "debian",
+  der: "cert",
+  diff: "diff",
+  dio: "drawio",
+  dll: "binary",
+  dmg: "binary",
+  doc: "word",
+  dockerfile: "docker",
+  dockerignore: "docker",
+  docx: "word",
+  dot: "graphviz",
+  dpr: "delphi",
+  drawio: "drawio",
+  dtd: "dtd",
+  dylib: "binary",
+  ear: "jar",
+  edn: "clojure",
+  eex: "eex",
+  ejs: "ejs",
+  elisp: "emacs",
+  elixir: "elixir",
+  env: "dotenv",
+  eot: "font",
+  eps: "eps",
+  epub: "epub",
+  erb: "erb",
+  erl: "erlang",
+  erlang: "erlang",
+  ex: "elixir",
+  excalidraw: "excalidraw",
+  exe: "binary",
+  exs: "elixir",
+  f: "fortran",
+  "f#": "fsharp",
+  f03: "fortran",
+  f08: "fortran",
+  f90: "fortran",
+  f95: "fortran",
+  fig: "image",
+  fish: "shell",
+  flac: "audio",
+  flutter: "flutter",
+  for: "fortran",
+  fortran: "fortran",
+  fs: "fsharp",
+  fsharp: "fsharp",
+  fsi: "fsharp",
+  fsproj: "fsproj",
+  fsx: "fsharp",
+  gif: "image",
+  gleam: "gleam",
+  go: "go",
+  golang: "go",
+  gpg: "gpg",
+  gql: "graphql",
+  gradle: "gradle",
+  graphql: "graphql",
+  graphqls: "graphql",
+  groovy: "groovy",
+  gsh: "groovy",
+  gv: "graphviz",
+  gvy: "groovy",
+  gy: "groovy",
+  gz: "zip",
+  h: "cheader",
+  "h++": "cppheader",
+  haml: "haml",
+  handlebars: "handlebars",
+  haskell: "haskell",
+  hbs: "handlebars",
+  hcl: "terraform",
+  heex: "eex",
+  heic: "image",
+  heif: "image",
+  hh: "cppheader",
+  hjs: "handlebars",
+  hpp: "cppheader",
+  hrl: "erlang",
+  hs: "haskell",
+  htm: "html",
+  html: "html",
+  http: "http",
+  hurl: "hurl",
+  hxx: "cppheader",
+  icns: "image",
+  ico: "favicon",
+  img: "binary",
+  ini: "ini",
+  ipa: "binary",
+  ipp: "cppheader",
+  ipynb: "jupyter",
+  iso: "binary",
+  j2: "jinja",
+  jade: "pug",
+  jar: "jar",
+  java: "java",
+  javascript: "js",
+  jenkinsfile: "jenkins",
+  jfif: "image",
+  jinja: "jinja",
+  jinja2: "jinja",
+  jl: "julia",
+  jpeg: "image",
+  jpg: "image",
+  js: "js",
+  json: "json",
+  json5: "json5",
+  jsonc: "json",
+  jsonl: "json",
+  jsonld: "jsonld",
+  jsp: "jsp",
+  jspx: "jsp",
+  jsx: "reactjs",
+  julia: "julia",
+  just: "just",
+  kdbx: "key",
+  key: "key",
+  kotlin: "kotlin",
+  ksh: "shell",
+  kt: "kotlin",
+  kts: "kotlin",
+  latex: "tex",
+  leex: "eex",
+  less: "less",
+  lhs: "haskell",
+  lib: "binary",
+  lock: "lucide:lock",
+  log: "log",
+  lpr: "delphi",
+  lua: "lua",
+  lz4: "zip",
+  m: "objectivec",
+  m4a: "audio",
+  m4v: "video",
+  mak: "gnu",
+  makefile: "gnu",
+  map: "map",
+  markdown: "markdown",
+  marko: "marko",
+  md: "markdown",
+  mdown: "markdown",
+  mdx: "mdx",
+  mermaid: "mermaid",
+  meson: "meson",
+  mid: "audio",
+  midi: "audio",
+  mjml: "mjml",
+  mjs: "js",
+  mk: "gnu",
+  mkd: "markdown",
+  mkv: "video",
+  ml: "ocaml",
+  mli: "ocaml-intf",
+  mll: "ocaml",
+  mly: "ocaml",
+  mm: "objectivec",
+  mmd: "mermaid",
+  mobi: "epub",
+  mojo: "mojo",
+  mov: "video",
+  mp3: "audio",
+  mp4: "video",
+  mpeg: "video",
+  mpg: "video",
+  msi: "binary",
+  mts: "typescript",
+  mustache: "handlebars",
+  mysql: "mysql",
+  nasm: "assembly",
+  ndjson: "json",
+  nginx: "nginx",
+  nim: "nim",
+  nimble: "nim",
+  nims: "nim",
+  nix: "nix",
+  nu: "nushell",
+  numbers: "excel",
+  nushell: "nushell",
+  o: "binary",
+  obj: "binary",
+  "objective-c": "objectivec",
+  objectivec: "objectivec",
+  ocaml: "ocaml",
+  odp: "powerpoint",
+  ods: "excel",
+  odt: "word",
+  ogg: "audio",
+  opus: "audio",
+  org: "org",
+  otf: "font",
+  p12: "cert",
+  pas: "delphi",
+  patch: "patch",
+  pcss: "postcss",
+  pdf: "pdf2",
+  pem: "cert",
+  perl: "perl",
+  pfx: "cert",
+  pgp: "gpg",
+  pgsql: "postgres",
+  php: "php",
+  php3: "php",
+  php4: "php",
+  php5: "php",
+  php7: "php",
+  phps: "php",
+  phtml: "php",
+  pkb: "sql",
+  pkg: "binary",
+  pks: "sql",
+  pl: "perl",
+  plaintext: "text",
+  plantuml: "plantuml",
+  plist: "xml",
+  plsql: "sql",
+  pm: "perl",
+  png: "image",
+  po: "locale",
+  postcss: "postcss",
+  pot: "locale",
+  powershell: "powershell",
+  pp: "delphi",
+  ppt: "powerpoint",
+  pptx: "powerpoint",
+  prisma: "prisma",
+  properties: "config",
+  props: "config",
+  proto: "protobuf",
+  protobuf: "protobuf",
+  ps1: "powershell",
+  psd: "photoshop",
+  psd1: "powershell",
+  psm1: "powershell",
+  pu: "plantuml",
+  pub: "key",
+  pug: "pug",
+  puml: "plantuml",
+  py: "python",
+  pyc: "python",
+  pyi: "python",
+  pyo: "python",
+  python: "python",
+  pyw: "python",
+  pyx: "python",
+  r: "r",
+  rake: "rake",
+  rar: "zip",
+  raw: "image",
+  razor: "razor",
+  rb: "ruby",
+  reg: "registry",
+  rej: "patch",
+  rest: "rest",
+  rmd: "rmd",
+  rpm: "binary",
+  rs: "rust",
+  rst: "text",
+  rtf: "word",
+  ruby: "ruby",
+  run: "binary",
+  rust: "rust",
+  s: "assembly",
+  s51: "assembly",
+  sass: "sass",
+  sbt: "sbt",
+  sc: "scala",
+  scala: "scala",
+  scpt: "applescript",
+  scss: "scss",
+  sh: "shell",
+  shell: "shell",
+  shellscript: "shell",
+  shellsession: "shell",
+  sig: "gpg",
+  sketch: "sketch",
+  sln: "sln",
+  slnx: "sln",
+  snap: "jest-snapshot",
+  so: "binary",
+  sol: "solidity",
+  solidity: "solidity",
+  sql: "sql",
+  sqlite: "sqlite",
+  sqlite3: "sqlite",
+  srt: "text",
+  ssa: "text",
+  sty: "tex",
+  styl: "stylus",
+  sv: "verilog",
+  svelte: "svelte",
+  svg: "svg",
+  svh: "verilog",
+  swift: "swift",
+  t: "perl",
+  tar: "zip",
+  templ: "templ",
+  terraform: "terraform",
+  tex: "tex",
+  text: "text",
+  textile: "textile",
+  tf: "terraform",
+  tfstate: "terraform",
+  tfvars: "terraform",
+  tgz: "zip",
+  tif: "image",
+  tiff: "image",
+  tofu: "opentofu",
+  toml: "toml",
+  ts: "typescript",
+  tsbuildinfo: "tsbuildinfo",
+  tsv: "excel",
+  tsx: "reactts",
+  ttf: "font",
+  twig: "twig",
+  txt: "text",
+  typ: "text",
+  typescript: "typescript",
+  v: "vlang",
+  vb: "vb",
+  vbproj: "vb",
+  verilog: "verilog",
+  vh: "verilog",
+  vhd: "vhdl",
+  vhdl: "vhdl",
+  vim: "vim",
+  viml: "vim",
+  vimrc: "vim",
+  vsh: "vlang",
+  vtt: "text",
+  vue: "vue",
+  vv: "vlang",
+  vy: "vyper",
+  war: "jar",
+  wasm: "wasm",
+  wat: "wasm",
+  wav: "audio",
+  webm: "video",
+  webmanifest: "manifest",
+  webp: "webp",
+  wiki: "wikitext",
+  wmv: "video",
+  woff: "font",
+  woff2: "font",
+  xcf: "gimp",
+  xd: "image",
+  xhtml: "html",
+  xls: "excel",
+  xlsx: "excel",
+  xml: "xml",
+  xsd: "xml",
+  xsl: "xml",
+  xslt: "xml",
+  xz: "zip",
+  yaml: "yaml",
+  yml: "yaml",
+  zig: "zig",
+  zip: "zip",
+  zsh: "shell",
+  zst: "zip",
+  "🔥": "mojo",
+};
+
+/** Directory names (lowercased) → `folder-type-*` key — aliases only; exact
+ * names resolve via the `folder-type-<name>` probe in `folderIcon`. */
+const DIR_NAMES: Record<string, string> = {
+  ".astro": "astro",
+  ".aws": "aws",
+  ".azure": "azure",
+  ".cache": "temp",
+  ".cargo": "cargo",
+  ".changeset": "changesets",
+  ".changesets": "changesets",
+  ".circleci": "circleci",
+  ".claude": "claude",
+  ".composer": "composer",
+  ".cursor": "cursor",
+  ".dart_tool": "dart",
+  ".devcontainer": "devcontainer",
+  ".docker": "docker",
+  ".expo": "expo",
+  ".gcp": "gcp",
+  ".gemini": "gemini",
+  ".git": "git",
+  ".github": "github",
+  ".gitlab": "gitlab",
+  ".gradle": "gradle",
+  ".grok": "grok",
+  ".husky": "husky",
+  ".idea": "idea",
+  ".junie": "junie",
+  ".kiro": "kiro",
+  ".mvn": "maven",
+  ".mypy_cache": "mypy",
+  ".netlify": "netlify",
+  ".next": "next",
+  ".nuget": "nuget",
+  ".nuxt": "nuxt",
+  ".pytest_cache": "pytest",
+  ".storybook": "story",
+  ".svelte-kit": "svelte",
+  ".tauri": "tauri",
+  ".turbo": "turbo",
+  ".vercel": "vercel",
+  ".vitepress": "vitepress",
+  ".vscode": "vscode",
+  ".windsurf": "windsurf",
+  ".yarn": "yarn",
+  ".zed": "zed",
+  "@types": "typings",
+  __mocks__: "mock",
+  __tests__: "test",
+  addons: "plugin",
+  apis: "api",
+  apps: "app",
+  assets: "asset",
+  auth: "sso",
+  bin: "binary",
+  bower_components: "bower",
+  build: "dist",
+  cache: "temp",
+  certificates: "certificate",
+  certs: "certificate",
+  charts: "kubernetes",
+  clients: "client",
+  cmd: "cli",
+  commands: "cli",
+  commons: "common",
+  components: "component",
+  conf: "config",
+  configs: "config",
+  controllers: "controller",
+  darwin: "macos",
+  data: "db",
+  database: "db",
+  databases: "db",
+  doc: "docs",
+  documentation: "docs",
+  dtos: "model",
+  elements: "component",
+  entities: "model",
+  env: "environments",
+  envs: "environments",
+  extensions: "plugin",
+  fixtures: "mock",
+  font: "fonts",
+  generated: "dist",
+  helm: "kubernetes",
+  helpers: "helper",
+  hooks: "hook",
+  i18n: "locale",
+  icons: "images",
+  image: "images",
+  imgs: "images",
+  includes: "include",
+  interfaces: "interfaces",
+  k8s: "kubernetes",
+  keys: "certificate",
+  l10n: "locale",
+  lang: "locale",
+  languages: "locale",
+  lib: "library",
+  libs: "library",
+  locales: "locale",
+  logs: "log",
+  media: "images",
+  middlewares: "middleware",
+  migrations: "db",
+  mocks: "mock",
+  models: "model",
+  modules: "module",
+  mongo: "mongodb",
+  node_modules: "node",
+  notebook: "notebooks",
+  out: "dist",
+  output: "dist",
+  packages: "package",
+  pages: "view",
+  pictures: "images",
+  pkg: "package",
+  plugins: "plugin",
+  providers: "services",
+  release: "dist",
+  router: "route",
+  routes: "route",
+  schemas: "model",
+  screens: "view",
+  scripts: "script",
+  secrets: "private",
+  servers: "server",
+  settings: "config",
+  spec: "test",
+  specs: "test",
+  "src-tauri": "tauri",
+  ssl: "certificate",
+  static: "public",
+  stories: "story",
+  styles: "style",
+  target: "dist",
+  templates: "template",
+  tests: "test",
+  themes: "theme",
+  tmp: "temp",
+  translations: "locale",
+  types: "typescript",
+  util: "helper",
+  utilities: "helper",
+  utils: "helper",
+  vendor: "package",
+  views: "view",
+  widgets: "component",
+  wiki: "docs",
+  win32: "windows",
+  wwwroot: "public",
+};
+
+const basename = (path: string): string =>
+  (path.split(/[\\/]/u).pop() ?? path).trim().toLowerCase();
+
+/** Iconify name for a file path, picked from its name and extension.
+ * `own` guards every table lookup: prototype members ("constructor",
+ * "toString") are valid file names but not icon keys. */
+export const fileIcon = (path: string): string => {
+  const base = basename(path);
+  const named = own(FILE_NAMES, base);
+  if (named !== undefined) {
+    return fileType(named);
+  }
+  for (const [re, key] of FILE_PATTERNS) {
+    if (re.test(base)) {
+      return fileType(key);
+    }
+  }
+  const tool = CONFIG_RE.exec(base)?.groups?.tool;
+  if (tool !== undefined) {
+    return fileType(own(CONFIG_TOOLS, tool) ?? "config");
+  }
+  const dot = base.lastIndexOf(".");
+  // `.gitignore`-style dotfiles carry no extension; an extensionless name is
+  // tried as one so bare lang ids ("ts", "python") also resolve.
+  let ext = "";
+  if (dot === -1) {
+    ext = base;
+  } else if (dot > 0) {
+    ext = base.slice(dot + 1);
+  }
+  if (ext !== "") {
+    const key = own(EXT_ICONS, ext);
+    if (key !== undefined) {
+      return fileType(key);
+    }
+    const probed = fileType(ext);
+    if (hasIcon(probed)) {
+      return probed;
+    }
+  }
+  return DEFAULT_FILE;
+};
+
+/** Iconify name for a directory, picked from its name. */
+export const folderIcon = (name: string): string => {
+  const base = basename(name.replace(/\/+$/u, ""));
+  const key = own(DIR_NAMES, base) ?? base;
+  const probed = folderType(key);
+  return hasIcon(probed) ? probed : DEFAULT_FOLDER;
+};