Icons: OpenIcon built in and on by default, icon("mail") draws the best glyph

[ralyodio]

OpenIcon (https://logicsrc.com/openicon) becomes hqtui's default, enabled icon pack.

import { icon, setIconMode } from "@profullstack/hqtui";
ui.text(`${icon("mail")} Inbox  ${icon("git-branch")} main`);
// 󰇰 Inbox   main  (Nerd Font) · ✉ Inbox  ⎇ main (UTF-8) · @ Inbox  Y main (ASCII)

• Glyph choice, in order: setIconMode() → OPENICON_GLYPHS / HQTUI_ICONS → NERD_FONT=1 → the existing detectCapabilities Unicode check. A Nerd Font is never assumed, because the font cannot be detected from inside the terminal.

• Fallbacks: aliases resolve (email → mail), an icon with no Nerd glyph falls back to Unicode, and an unknown name returns "" rather than throwing mid-frame.

• Custom sets: useIconPack(iconPackFrom(openiconJson)) swaps in any other OpenIcon set.

• 370 icons: 259 UI icons and 111 brands. The table is generated by packages/hqtui/scripts/generate-icons.ts from github.com/profullstack/openicon into:

  • the TS library (src/icons-data.ts)
  • Go (ports/go/icons_data.go, Icon, IconIn, IconModeIn)
  • Python (hqtui.icon, icon_mode)
  • Rust (hqtui::icon, icon_in, icon_mode_in)

  The Rust table is sorted and binary-searched. The only change to existing code is detect_unicode, which becomes pub(crate).

• Docs: a new Icons section at hqtui.com/docs#icons and in the package README.

Tests, run locally:

• TypeScript: node --test 337/337 and bun test packages/hqtui/test 337 pass; 7 are new icon tests.
• Go: go test -race ./... passes.
• Rust: cargo test --all-targets passes.
• Python: python -m unittest discover -s tests -t . 40 OK.
• Typecheck: the library and apps/web typecheck clean. typecheck:demo failed locally only because this worktree's node_modules links to an older built dist without copyMarkdown (Add Markdown copy controls for summary panes #94); CI does a fresh install.

Not done:

• The Zig port, the C/C++ core and the Ruby/PHP/Perl bindings have no icon API yet.
• No version bump; that belongs in the release PR.

Related: profullstack/cli-tools#81 (the icon builder), profullstack/logicsrc#198 (the OpenIcon spec).

🤖 Generated with Claude Code