fix(font): bundled font now actually renders, ship Inter Light, +CJK fallback
Security / scan (push) Successful in 19s
Build / Build (Release) (push) Successful in 29s
Forge Announce / Post changelog to Hellion Forge (push) Successful in 5s
Release / Build and attach release ZIP (push) Successful in 49s

Plugin.cs:937 only pushed RegularFont when Config.FontsEnabled was true.
  FontsAndColours.cs:50 forces FontsEnabled=false whenever UseHellionFont is
  enabled (to hide the chooser UI), so the bundled-font path was silently
  dead and the FFXIV Axis game-font took over. Exo 2 looked "almost right"
  because it overlaps Axis on basic Latin, so the regression went unnoticed
  for the entire v1.5.x series.

  The fix routes RegularFont through draw whenever either FontsEnabled or
  UseHellionFont is on. First-frame HITCH dropped from ~74 ms to ~20 ms
  median (5-reload Linux/Wine sample 17.9-23.6 ms) as a side effect — the
  v1.5.1 "too optimistic" defer-pattern hypothesis was actually a symptom
  of this bug, not bad math.

  Font-stack overhaul on top:
  - Inter Light (Static 18pt-Light, 343 KB, SIL OFL 1.1) replaces Exo 2 as
    the bundled font. Inter ships full Latin Extended-A/B, Greek polytonic
    and Cyrillic Supplement coverage.
  - NotoSansCjkRegular added as a third merge layer for Hangul,
    Simplified-Chinese-specific Han glyphs, and CJK fallbacks the FFXIV
    Japanese font does not ship.
  - Two new ExtraGlyphRanges flags (LatinExtended, Greek) implemented via
    AddChar pair lists in SetUpRanges.
  - Settings.Apply auto-activates the matching ExtraGlyphRanges flag on
    language change. Plugin.LoadAsync runs a one-shot migration that ORs
    in the required flag for an already-selected language.
  - ExtraGlyphRanges CollapsingHeader reachable regardless of
    UseHellionFont (was hidden in the early-return branch).
  - New WarningText below the language combo: FFXIV's chat engine only
    fully supports EN/DE/FR/JA. Other scripts render in the HellionChat
    UI but may garble in in-game chat input/send.

  Localisation wave (originally a FR-only cycle):
  - 24 selectable UI languages. LanguageOverride enum gains 10 new locales
    plus 3 previously commented-out (Italian, Korean, Norwegian with ISO
    code `nb` instead of `no`). All new values append to keep existing
    user-config integer serialisation stable.
  - Resource bundle split: HellionStrings.resx (24 locales, 328 keys) for
    fork-added strings, Language.resx (24 locales, 456 keys) for the
    ChatTwo-Crowdin-heritage. 4 post-sync Crowdin keys backfilled into
    13 legacy locales with per-key AI-assisted comment marker.
  - Em-dash sweep on EN source plus 18 translations. Russian and Ukrainian
    keep their typographic norm.

  Old HellionFont.ttf + HellionFont-OFL.txt removed; Inter-Light.ttf +
  Inter-OFL.txt take their place. Configuration field UseHellionFont keeps
  its name for backwards-compat. Migration v17 stays.
This commit is contained in:
2026-05-19 17:24:17 +02:00
parent 38586db9d8
commit 35e8d3a7fe
68 changed files with 3435 additions and 293 deletions
+36 -6
View File
@@ -10,13 +10,43 @@ be a poor fit for the plugin's privacy-first scope during brainstorming.
---
## Next Cycle (v1.5.3)
## Next Cycle
**French localisation.** Strings from `Resources/HellionStrings.resx` get a FR translation pass
(DeepL first draft), then Hezcal native-speaker review before release. After that, the Plugin
Integrations Wave 2-6 (Context-Menu, NotificationMaster, Moodles, ExtraChat, XIVIM Quick-DM) and the
UiBuilder first-frame HITCH investigation that v1.5.1 surfaced are queued behind it, alongside the
Wine/Linux scroll-rubber-band spike at the tail.
**Plugin Integrations Wave 2-6** (Context-Menu, NotificationMaster, Moodles, ExtraChat, XIVIM
Quick-DM) is the next planned scope. The UiBuilder first-frame HITCH investigation that v1.5.1
queued is now closed as a side effect of v1.5.3's font-stack fix — HITCH dropped from ~74 ms into
the 15-25 ms range. The Wine/Linux scroll-rubber-band spike remains at the tail.
Native-speaker review of the AI-assisted v1.5.3 translations (13 legacy Crowdin locales) runs in
parallel as a continuous correction pass, gathered via the Hellion Forge Discord.
---
## v1.5.3 — Localisation Wave + Bundled-Font Overhaul (released 2026-05-19)
Twenty-four selectable UI languages: from FR-only as the original plan scope, the cycle expanded to
cover Catalan, Czech, Danish, Finnish, Greek, Hungarian, Italian, Korean, Norwegian, Polish,
Portuguese (Portugal), Turkish and Ukrainian alongside the existing Crowdin-heritage locales, all
AI-translated and flagged for community review. Bundled font swaps from Exo 2 to **Inter Light**
for wider European glyph coverage (Latin Extended-A/B, Greek polytonic, Cyrillic Supplement);
**NotoSansCjkRegular** joins as a third merge layer so Hangul and Simplified-Chinese-specific Han
glyphs render correctly inside the HellionChat UI.
First-frame HITCH dropped from **~74 ms to a median of ~20 ms** (5-reload sample 17.9-23.6 ms,
Linux/Wine) as a side effect: the bundled-font path was silently falling back to the FFXIV Axis
game font for the entire v1.5.x series because of an early-return in `Plugin.cs:937`. The fix
routes `RegularFont` through draw whenever either `FontsEnabled` or `UseHellionFont` is on, and
lands the defer-pattern win v1.5.1 was reaching for.
`ExtraGlyphRanges` auto-activates the matching flag on language change. Two new flags
(`LatinExtended`, `Greek`) join the existing set. Plugin init runs a one-shot migration that ORs
the required flag into the saved config for users updating from v1.5.2 with a non-default language
already selected. A WarningText under the language dropdown notes that FFXIV's own chat input only
fully supports EN/DE/FR/JA — other languages may garble when typed into in-game chat.
Migration v17 stays. `LanguageOverride` enum grows by ten locales plus three previously
commented-out (Italian, Korean, Norwegian with code `nb`); all new values append to keep existing
user-config integer serialisation stable.
---