Skip to content

v1.2.1

Latest

Choose a tag to compare

@cluster1900 cluster1900 released this 04 Nov 10:19
· 5 commits to main since this release

Install the CLI with npm install -g apexo-code@1.2.1, or download a standalone CLI archive below. Keep the CLI and its workflow interpreter together.

Desktop installers are available for macOS Apple Silicon, Linux x64, and Windows x64. The current macOS build uses an ad-hoc signature without notarization; the Windows build has no publisher certificate.

Detailed installation guide · Release automation guide

Verify downloads using the attached SHA256SUMS.

Highlights & Recent Changes (v1.2.0 → v1.2.1)

1. TUI Theme Contrast & Invisible Text Fixes (packages/tui) (#203)

  • Transparent Background & Selection Foreground Guard (selectedForeground): Fixed an alpha-channel bug in selectedForeground(theme, bg) where themes with background: "transparent" (such as lucent-orng) had theme.background.luminance() === 0 and returned transparent RGBA(0, 0, 0, 0) text for highlighted list items, dialog buttons, and badges. selectedForeground() now ignores transparent backgrounds, checks contrast (>= 4.5:1) against the target highlight surface (bg ?? theme.primary), and falls back to opaque #000000 or #ffffff.
  • Automatic Theme Token Contrast Normalization (resolveTheme): Enforced readable contrast floors across canvas, panel, and element surfaces for all 34 built-in TUI themes and system in both dark and light modes (primary text >= 4.5:1, semantic/syntax/markdown tokens >= 3.2:1, muted/comment/diff-context tokens >= 2.8:1, and selectedListItemText >= 4.5:1).
  • Built-in Theme Asset Fixes (lucent-orng, catppuccin-frappe, catppuccin-macchiato, vesper):
    • Added opaque panel, element, and menu surfaces to lucent-orng.json while keeping the root canvas transparent.
    • Added proper Catppuccin Latte light-mode palettes to catppuccin-frappe.json and catppuccin-macchiato.json.
    • Added distinct dark panel/element surfaces and high-contrast light-mode tokens to vesper.json.
  • Opaque Floating Surfaces & Reactive /theme Live Preview:
    • Updated Dialog and Toast containers to fall back to an opaque surface when theme.backgroundPanel.a < 0.85, preventing underlying transcript text from bleeding through modals.
    • Made DialogSelect option and footer action foregrounds reactive (createMemo) and switched the filter input focusedTextColor from theme.textMuted to theme.text.

2. CLI --mini Footer & System Theme Fixes (packages/apexo) (#203)

  • Footer Menu Selected Row Contrast: Fixed dark-on-dark active menu row text (~1.15:1 contrast) in --mini mode by pairing footer.selected = footerTheme.backgroundElement with footer.selectedText = footerTheme.text.
  • System Light-Mode Fallback: Fixed generateSystem so light mode falls back to #fafafa / #1f2937 instead of palette[0] (#000000) when the terminal does not report a defaultBackground.

3. Desktop / Web Theme Contrast & Typography (packages/ui) (#203)

  • Accurate sRGB Relative Luminance: Fixed the green channel luminance weight in packages/ui/src/theme/color.ts (0.587 → 0.7152).
  • Desktop V1 & V2 Theme Contrast Guardrails: Enforced contrast minimums across V1 (text-base >= 4.5:1, text-weak >= 3.5:1) and V2 (v2-text-text-base >= 4.5:1, v2-text-text-muted >= 4.2:1, v2-text-text-faint >= 2.8:1) foreground resolvers, and updated catppuccin-frappe.json, catppuccin-macchiato.json, and matrix.json in packages/ui.
  • System & CJK Font Fallbacks: Added system UI and CJK fallback fonts (PingFang SC, Hiragino Sans GB, Microsoft YaHei) to --font-family-text, --v2-font-family-sans, and --font-family-sans.

Pull Requests Included

  • fix(ui): enforce readable theme contrast across tui, cli, and desktop by @cluster1900 in #203

Full Changelog: v1.2.0...v1.2.1