Merge branch 'feature/v1.5.4'

release(v1.5.4): manifest bump and forge post
Bumps csproj, yaml, repo.json, CHANGELOG, ROADMAP and README in lock-step to 1.5.4. Forge-post DE-body added with the Polish & Motion versionsnatur. Slim-rule applied to the yaml and repo.json changelog blocks (keeps v1.5.4 + v1.5.3 + v1.5.2 + v1.5.1, drops v1.5.0). A csharpier reflow of two v1.5.4 source files (ChatLogWindow, HellionStyle) is folded in. preflight.sh blocks A-F all green.
2026-05-20 16:42:39 +02:00 · 2026-05-20 16:32:42 +02:00 · 2026-05-20 16:21:29 +02:00 · 2026-05-20 14:42:21 +02:00 · 2026-05-20 13:26:16 +02:00 · 2026-05-20 12:48:31 +02:00
83 changed files with 42212 additions and 446 deletions
@@ -0,0 +1,10 @@
+---
+subtitle: "First-Run Wizard — neu in 4 Steps, Roleplay-Profil neu"
+versionsnatur: "UX-Patch"
+---
+- **Vier Steps statt Single-Page.** Der First-Run-Wizard öffnet jetzt in vier Bühnen: Willkommen → Privacy-Profil → Power-Settings → Fertig. Pagination-Dots in Forge-Bronze oben rechts, Back/Skip/Next im Footer. Standardgröße 720×480 (Min 600×400) und der Fuchs-Banner sitzt als zugeklappter TreeNode oben in Step 1, damit die Einleitung im Fokus bleibt.
+- **Neues Privacy-Profil „Roleplay".** Datensparsamkeit plus Sagen und beide Emote-Typen für Story-Logs. Schreien und Rufen bleiben außen vor, Public-Distance-Lärm von Fremden ist kein Story-Inhalt. Aufbewahrung: Sagen 30 Tage, Emotes 90 Tage. Privacy-Picker wird zum 2×2-Grid, Casual bleibt mit ★-Marker als Empfehlung.
+- **Power-Settings sichtbar.** Bislang versteckte Defaults bekommen eine eigene Bühne: Vorherige Session laden, Filter inkl. alter Messages, N Tell-Messages vorladen, Compact-Density, Prettier-Timestamps und Theme-Picker für die 10 Built-in-Themes. Keine neuen Settings, nur das Bestehende sauber sichtbar.
+- **Staged-Commit und Test-Hint auf der Fertig-Bühne.** Auswahl wird erst beim Klick auf „Fertig ✓" geschrieben. „Später entscheiden" oder X-Close lässt die bestehende Config unangetastet, ein nicht angefasster Step behält die alten Werte. Direkt darunter sichtbar: „Tipp /tell <Spielername>", plus die aktuelle Preload-Zahl aus Step 3 als Hinweis auf den Auto-Tell-Tab-Spawn.
+- **Bestehende User sehen den neuen Wizard einmal.** Wer schon v1.5.1 hatte, bekommt den Multi-Step-Flow beim ersten v1.5.2-Boot aufgepoppt. Neues Config-Feld `WizardLastShownVersion` triggert das einmalig pro Wizard-Rework; Skip oder Finish reicht und danach öffnet er nicht mehr automatisch.
+- **Unter der Haube.** Pure-Helper-Tests für alle vier Profile-Sets in der Build-Suite (zwölf neue Facts), plus ein WizardStateSmokeStep für `/xlperf`. Migration v17 bleibt, nur ein optionales Config-Feld kommt dazu.
@@ -0,0 +1,9 @@
+---
+subtitle: "24 Sprachen, Inter Light statt Exo 2, HITCH 74 → 20 ms"
+versionsnatur: "Localisation + Font-Stack"
+---
+- **24 wählbare UI-Sprachen.** Aus dem ursprünglich nur als FR-Lokalisierung geplanten Cycle ist eine breite Welle geworden: Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hungarian, Italian, Japanese, Korean, Norsk bokmål, Polish, Portuguese (BR), Portuguese (PT), Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian, Simplified Chinese, Traditional Chinese. Dropdown sortiert alphabetisch nach Endonym, „None" oben angepinnt. Nicht-native Übersetzungen sind AI-assisted und für Community-Review im Forge-Discord markiert.
+- **Inter Light statt Exo 2 als bundled Schrift.** Plus NotoSansCjkRegular als dritte Merge-Schicht. Damit deckt der Stack Latin Extended-A/B, Greek polytonic, Cyrillic Supplement und CJK (inkl. Hangul, Simplified-Han nach Reform) ab — die nicht-vanilla-FFXIV-Sprachen waren mit Exo 2 nicht lesbar.
+- **HITCH 74 → ~20 ms als Side-Effect.** Der UiBuilder-First-Frame-Lag lag seit v1.4.x stabil bei 74 ms; v1.5.1 wollte ihn in Richtung 7 ms ziehen, fiel als „Hypothese zu optimistisch" durch. Echter Grund: `Plugin.cs:937` push'te `RegularFont` nur wenn `FontsEnabled` true war — die „Mitgelieferte Schrift verwenden"-Logik setzte `FontsEnabled = false` mit, der bundled-Pfad war die ganze v1.5.x-Reihe tot, FFXIVs Axis-Font übernahm und kostete ~50 ms extra. Fix routet `RegularFont` jetzt auch über `UseHellionFont`. Median ~20 ms im 5-Reload-Stresstest (17.9-23.6 ms, Linux/Wine; Windows-Baseline steht aus).
+- **Glyph-Ranges aktivieren sich automatisch beim Sprachwechsel** plus eine One-Shot-Migration für User die schon eine non-Latin-Sprache eingestellt hatten. Neue WarningText unter dem Sprach-Dropdown weist darauf hin, dass FFXIVs Chat-Engine offiziell nur EN/DE/FR/JA-Glyphen rendert — andere Schriften können in der Game-Eingabe Garbled-Output zeigen.
+- **Unter der Haube.** Drei-Layer-Font-Stack, zwei neue ExtraGlyphRanges-Flags (`LatinExtended`, `Greek`), `LanguageOverride`-Enum wächst um zehn Locales plus drei reaktivierte (Italian, Korean, Norwegian mit `nb`). Append-only damit User-Configs stabil bleiben. Migration v17 bleibt.
@@ -0,0 +1,9 @@
+---
+subtitle: "Theme-Crossfade, Quick-Picker, Hover-Animationen"
+versionsnatur: "Polish & Motion"
+---
+- **Theme-Crossfade.** Theme-Wechsel blenden jetzt sanft über rund 300 ms ineinander, statt hart umzuschalten. Alle Hellion-Flächen gleiten mit: Sidebar, Titel, Buttons, Tabs, Scrollbar, Trennlinien. Der Fenster-Hintergrund snappt bewusst weiter, damit das Per-Window-Deckkraft-Setting aus Dalamuds Pinning-Menü unangetastet bleibt.
+- **Header-Quick-Picker.** Neuer Paletten-Button links vom Zahnrad im Chat-Header. Ein Klick öffnet ein kompaktes Popup mit zwei Sektionen: alle Built-in- und Custom-Themes sowie alle Tabs. Der aktive Eintrag trägt ein Häkchen, ein Klick wechselt ohne das Popup zu schließen. So lassen sich mehrere Wechsel hintereinander erledigen, ohne den Umweg über die Einstellungen.
+- **Sanfte Hover-Animationen.** Sidebar-Icons faden bei Hover sanft von gedimmt auf volle Deckkraft. Card-Mode-Trennlinien heben sich beim Überfahren einer Zeile für den ganzen Tab dezent ab. Beides framerate-unabhängig gerechnet, also auch bei Wine-Stall-Frames stabil.
+- **Bewegung reduzieren.** Neuer Toggle im Tab für Theme und Layout. Er deaktiviert Crossfade, Hover-Animationen und das Pulsieren ungelesener Tabs für alle, die eine statische Oberfläche bevorzugen.
+- Drei P3-Items plus der Accessibility-Toggle, kein Schema-Bump, keine Migration. Eine kleine Polish-Welle vor den größeren Cycles.
@@ -100,6 +100,15 @@ public class Configuration : IPluginConfiguration
    public Dictionary<ChatType, int> RetentionPerChannelDays = [];
    public DateTimeOffset RetentionLastRunAt = DateTimeOffset.MinValue;
    public bool FirstRunCompleted;
+
+    // Tracks which plugin version last surfaced the first-run wizard.
+    // When the running version is newer than this, Plugin.LoadAsync
+    // re-opens the wizard once so existing users see major UX reworks
+    // (e.g. the v1.5.2 multi-step rewrite). Skip path and Finish both
+    // set FirstRunCompleted = true on close, so the wizard only fires
+    // once per version bump even if the user dismisses it.
+    public string WizardLastShownVersion = string.Empty;
+
    public bool UseHellionFont = true;
    public bool ShowHonorificTitleInHeader = true;

@@ -336,6 +345,7 @@ public class Configuration : IPluginConfiguration
        RetentionLastRunAt = other.RetentionLastRunAt;

        FirstRunCompleted = other.FirstRunCompleted;
+        WizardLastShownVersion = other.WizardLastShownVersion;
        UseHellionFont = other.UseHellionFont;
        ShowHonorificTitleInHeader = other.ShowHonorificTitleInHeader;
        ShowHonorificGlow = other.ShowHonorificGlow;
@@ -475,6 +485,17 @@ public class Tab
    [NonSerialized]
    internal string? _cachedTellIcon;

+    // PM-3 hover-lerp state. Default 0f means "not hovered". Sidebar
+    // path animates per tab; card-mode-border path is tab-aggregate
+    // (any card-row hover ramps the alpha for all cards in this tab).
+    // Lerp speed lives in the render loop, not here, so the same field
+    // serves both sites at the same animation curve.
+    [NonSerialized]
+    internal float _hoverAlpha;
+
+    [NonSerialized]
+    internal float _cardHoverAlpha;
+
    public bool Matches(Message message)
    {
        if (!message.Matches(SelectedChannels, ExtraChatAll, ExtraChatChannels))
@@ -823,17 +844,27 @@ public enum LanguageOverride
    French,
    German,
    Greek,
-
-    // Italian,
    Japanese,
-
-    // Korean,
-    // Norwegian,
    PortugueseBrazil,
    Romanian,
    Russian,
    Spanish,
    Swedish,
+
+    // v1.5.3: Crowdin-heritage activated and Forge-maintained additions.
+    // Append-only to preserve serialized integer values of existing user configs.
+    Italian,
+    Korean,
+    Norwegian,
+    Catalan,
+    Czech,
+    Danish,
+    Finnish,
+    Hungarian,
+    Polish,
+    PortuguesePortugal,
+    Turkish,
+    Ukrainian,
 }

 public static class LanguageOverrideExt
@@ -849,15 +880,24 @@ public static class LanguageOverrideExt
            LanguageOverride.French => "Français",
            LanguageOverride.German => "Deutsch",
            LanguageOverride.Greek => "Ελληνικά",
-            // LanguageOverride.Italian => "Italiano",
+            LanguageOverride.Italian => "Italiano",
            LanguageOverride.Japanese => "日本語",
-            // LanguageOverride.Korean => "한국어 (Korean)",
-            // LanguageOverride.Norwegian => "Norsk",
+            LanguageOverride.Korean => "한국어",
+            LanguageOverride.Norwegian => "Norsk bokmål",
            LanguageOverride.PortugueseBrazil => "Português do Brasil",
            LanguageOverride.Romanian => "Română",
            LanguageOverride.Russian => "Русский",
            LanguageOverride.Spanish => "Español",
            LanguageOverride.Swedish => "Svenska",
+            LanguageOverride.Catalan => "Català",
+            LanguageOverride.Czech => "Čeština",
+            LanguageOverride.Danish => "Dansk",
+            LanguageOverride.Finnish => "Suomi",
+            LanguageOverride.Hungarian => "Magyar",
+            LanguageOverride.Polish => "Polski",
+            LanguageOverride.PortuguesePortugal => "Português (Portugal)",
+            LanguageOverride.Turkish => "Türkçe",
+            LanguageOverride.Ukrainian => "Українська",
            _ => throw new ArgumentOutOfRangeException(nameof(mode), mode, null),
        };

@@ -872,17 +912,47 @@ public static class LanguageOverrideExt
            LanguageOverride.French => "fr",
            LanguageOverride.German => "de",
            LanguageOverride.Greek => "el",
-            // LanguageOverride.Italian => "it",
+            LanguageOverride.Italian => "it",
            LanguageOverride.Japanese => "ja",
-            // LanguageOverride.Korean => "ko",
-            // LanguageOverride.Norwegian => "no",
+            LanguageOverride.Korean => "ko",
+            LanguageOverride.Norwegian => "nb",
            LanguageOverride.PortugueseBrazil => "pt-br",
            LanguageOverride.Romanian => "ro",
            LanguageOverride.Russian => "ru",
            LanguageOverride.Spanish => "es",
            LanguageOverride.Swedish => "sv",
+            LanguageOverride.Catalan => "ca",
+            LanguageOverride.Czech => "cs",
+            LanguageOverride.Danish => "da",
+            LanguageOverride.Finnish => "fi",
+            LanguageOverride.Hungarian => "hu",
+            LanguageOverride.Polish => "pl",
+            LanguageOverride.PortuguesePortugal => "pt-pt",
+            LanguageOverride.Turkish => "tr",
+            LanguageOverride.Ukrainian => "uk",
            _ => throw new ArgumentOutOfRangeException(nameof(mode), mode, null),
        };
+
+    // Maps a language to the ExtraGlyphRanges flag required for full UI
+    // rendering in that locale. The settings save path ORs this into
+    // Mutable.ExtraGlyphRanges so users do not need to know which range
+    // to tick manually. Returns 0 for locales fully covered by the default
+    // ImGui glyph range (Latin-1) or by the separate Japanese font handle.
+    public static ExtraGlyphRanges RequiredGlyphRanges(this LanguageOverride mode) =>
+        mode switch
+        {
+            LanguageOverride.Korean => ExtraGlyphRanges.Korean,
+            LanguageOverride.ChineseSimplified => ExtraGlyphRanges.ChineseSimplifiedCommon,
+            LanguageOverride.ChineseTraditional => ExtraGlyphRanges.ChineseFull,
+            LanguageOverride.Ukrainian => ExtraGlyphRanges.Cyrillic,
+            LanguageOverride.Greek => ExtraGlyphRanges.Greek,
+            LanguageOverride.Czech
+            or LanguageOverride.Polish
+            or LanguageOverride.Romanian
+            or LanguageOverride.Hungarian
+            or LanguageOverride.Turkish => ExtraGlyphRanges.LatinExtended,
+            _ => 0,
+        };
 }

 [Serializable]
@@ -896,10 +966,23 @@ public enum ExtraGlyphRanges
    Korean = 1 << 4,
    Thai = 1 << 5,
    Vietnamese = 1 << 6,
+
+    // v1.5.3: Custom ranges for languages with Latin Extended-A glyphs (Czech,
+    // Polish, Romanian, Turkish, Hungarian) and Greek polytonic accents.
+    LatinExtended = 1 << 7,
+    Greek = 1 << 8,
 }

 public static class ExtraGlyphRangesExt
 {
+    // Custom (start, end) inclusive pair lists for ranges that ImGui does
+    // not ship a built-in helper for. SetUpRanges() feeds these into
+    // ImFontGlyphRangesBuilder.AddChar via the `chars` parameter of
+    // BuildRange so we avoid the lifetime/pinning question that the native
+    // GetGlyphRanges*-pointer pathway papers over.
+    internal static readonly ushort[] LatinExtendedPairs = { 0x0100, 0x024F };
+    internal static readonly ushort[] GreekPairs = { 0x0370, 0x03FF, 0x1F00, 0x1FFF };
+
    public static string Name(this ExtraGlyphRanges ranges) =>
        ranges switch
        {
@@ -911,6 +994,8 @@ public static class ExtraGlyphRangesExt
            ExtraGlyphRanges.Korean => Language.ExtraGlyphRanges_Korean_Name,
            ExtraGlyphRanges.Thai => Language.ExtraGlyphRanges_Thai_Name,
            ExtraGlyphRanges.Vietnamese => Language.ExtraGlyphRanges_Vietnamese_Name,
+            ExtraGlyphRanges.LatinExtended => Language.ExtraGlyphRanges_LatinExtended_Name,
+            ExtraGlyphRanges.Greek => Language.ExtraGlyphRanges_Greek_Name,
            _ => throw new ArgumentOutOfRangeException(nameof(ranges), ranges, null),
        };

@@ -925,6 +1010,10 @@ public static class ExtraGlyphRangesExt
            ExtraGlyphRanges.Korean => (nint)ImGui.GetIO().Fonts.GetGlyphRangesKorean(),
            ExtraGlyphRanges.Thai => (nint)ImGui.GetIO().Fonts.GetGlyphRangesThai(),
            ExtraGlyphRanges.Vietnamese => (nint)ImGui.GetIO().Fonts.GetGlyphRangesVietnamese(),
+            // LatinExtended and Greek are applied via builder.AddChar in
+            // FontManager.SetUpRanges, not through a native pointer range.
+            ExtraGlyphRanges.LatinExtended => 0,
+            ExtraGlyphRanges.Greek => 0,
            _ => throw new ArgumentOutOfRangeException(nameof(ranges), ranges, null),
        };
 }
@@ -9,7 +9,7 @@ using Dalamud.Plugin;

 namespace HellionChat;

-// Two LogProxy sites live in static methods (TryGetHellionFontBytes,
+// Two LogProxy sites live in static methods (TryGetBundledFontBytes,
 // AddFontWithFallback); a ctor-injected ILogger would not be reachable
 // from those scopes, so the class stays on Plugin.LogProxy.
 //
@@ -62,8 +62,8 @@ public sealed class FontManager : IDisposable
        90f,
    ];

-    // Hellion font bytes (Exo 2, OFL-1.1); lazily loaded from manifest resources
-    private static byte[]? HellionFontBytes;
+    // Bundled UI font bytes (Inter Light, OFL-1.1); lazily loaded from manifest resources
+    private static byte[]? BundledFontBytes;

    public FontManager(IDalamudPluginInterface pluginInterface)
    {
@@ -122,7 +122,7 @@ public sealed class FontManager : IDisposable
            e.OnPreBuild(tk =>
            {
                // UseHellionFont swaps the source font but keeps the size
-                // selector tied to FontSizeV2 (the Hellion font ships as
+                // selector tied to FontSizeV2 (the bundled font ships as
                // a single weight).
                var basePt = Plugin.Config.UseHellionFont
                    ? Plugin.Config.FontSizeV2
@@ -130,15 +130,28 @@ public sealed class FontManager : IDisposable
                var config = new SafeFontConfig { SizePt = basePt, GlyphRanges = Ranges };
                // Missing embedded resource falls back to the configured
                // system font instead of taking the whole UiBuilder down.
-                var hellionBytes = Plugin.Config.UseHellionFont ? TryGetHellionFontBytes() : null;
-                config.MergeFont = hellionBytes is not null
-                    ? tk.AddFontFromMemory(hellionBytes, config, "Hellion-Exo2")
+                var bundledBytes = Plugin.Config.UseHellionFont ? TryGetBundledFontBytes() : null;
+                config.MergeFont = bundledBytes is not null
+                    ? tk.AddFontFromMemory(bundledBytes, config, "Inter-Light")
                    : AddFontWithFallback(tk, Plugin.Config.GlobalFontV2.FontId, config, "global");

                config.SizePt = Plugin.Config.JapaneseFontV2.SizePt;
                config.GlyphRanges = JpRange;
                AddFontWithFallback(tk, Plugin.Config.JapaneseFontV2.FontId, config, "japanese");

+                // v1.5.3: NotoSansCjk fallback covers Hangul, Simplified-Chinese
+                // -specific Han (e.g. 简) and other CJK glyphs that the primary
+                // (Inter Light / global font) and the FFXIV Japanese font do not
+                // ship. Merged last so earlier fonts win for shared codepoints.
+                config.SizePt = basePt;
+                config.GlyphRanges = Ranges;
+                AddFontWithFallback(
+                    tk,
+                    new DalamudAssetFontAndFamilyId(DalamudAsset.NotoSansCjkRegular),
+                    config,
+                    "noto-cjk-fallback"
+                );
+
                config.SizePt = Plugin.Config.SymbolsFontSizeV2;
                tk.AddGameSymbol(config);

@@ -166,6 +179,16 @@ public sealed class FontManager : IDisposable
                config.GlyphRanges = JpRange;
                AddFontWithFallback(tk, Plugin.Config.JapaneseFontV2.FontId, config, "japanese");

+                // v1.5.3: NotoSansCjk fallback (see BuildRegularFontHandle).
+                config.SizePt = Plugin.Config.ItalicFontV2.SizePt;
+                config.GlyphRanges = Ranges;
+                AddFontWithFallback(
+                    tk,
+                    new DalamudAssetFontAndFamilyId(DalamudAsset.NotoSansCjkRegular),
+                    config,
+                    "noto-cjk-fallback"
+                );
+
                config.SizePt = Plugin.Config.SymbolsFontSizeV2;
                tk.AddGameSymbol(config);

@@ -187,26 +210,26 @@ public sealed class FontManager : IDisposable
    // happen on a signed release build, but a broken csproj or hand-rolled
    // dev build can land here. Caller falls back to the system font path
    // so the plugin still loads instead of crashing the whole UiBuilder.
-    private static byte[]? TryGetHellionFontBytes()
+    private static byte[]? TryGetBundledFontBytes()
    {
-        if (HellionFontBytes is not null)
-            return HellionFontBytes;
+        if (BundledFontBytes is not null)
+            return BundledFontBytes;

        using var stream = typeof(FontManager).Assembly.GetManifestResourceStream(
-            "HellionFont.ttf"
+            "Inter-Light.ttf"
        );
        if (stream is null)
        {
            Plugin.LogProxy.Warning(
-                "Hellion font resource missing — falling back to system default font."
+                "Bundled Inter Light font resource missing, falling back to system default font."
            );
            return null;
        }

        using var ms = new MemoryStream();
        stream.CopyTo(ms);
-        HellionFontBytes = ms.ToArray();
-        return HellionFontBytes;
+        BundledFontBytes = ms.ToArray();
+        return BundledFontBytes;
    }

    private unsafe void SetUpRanges()
@@ -239,6 +262,18 @@ public sealed class FontManager : IDisposable
            builder.AddText("Œœ");
            builder.AddText("ĂăÂâÎîȘșȚț");

+            // v1.5.3: language-dropdown endonyms. The dropdown renders
+            // with the currently active font range; without these glyphs
+            // a user on an English UI cannot read non-Latin language names
+            // before switching. Auto-activation in Settings.Apply then
+            // pulls in the full ExtraGlyphRange for the chosen locale.
+            builder.AddText(
+                "Català Čeština Dansk Deutsch Ελληνικά English Español Suomi"
+                    + " Français Magyar Italiano 日本語 한국어 Norsk bokmål Nederlands"
+                    + " Polski Português Brasil (Portugal) Română Русский Svenska"
+                    + " Türkçe Українська 简体中文 繁體中文"
+            );
+
            // "Enclosed Alphanumerics" (partial) https://www.compart.com/en/unicode/block/U+2460
            for (var i = 0x2460; i <= 0x24B5; i++)
                builder.AddChar((char)i);
@@ -248,11 +283,32 @@ public sealed class FontManager : IDisposable
        }

        var ranges = new List<nint> { (nint)ImGui.GetIO().Fonts.GetGlyphRangesDefault() };
+        var customChars = new List<ushort>();
        foreach (var extraRange in Enum.GetValues<ExtraGlyphRanges>())
-            if (Plugin.Config.ExtraGlyphRanges.HasFlag(extraRange))
-                ranges.Add(extraRange.Range());
+        {
+            if (!Plugin.Config.ExtraGlyphRanges.HasFlag(extraRange))
+                continue;

-        Ranges = BuildRange(null, ranges.ToArray());
+            // LatinExtended and Greek use AddChar pairs because they have no
+            // built-in ImGui range helper; everything else points to a native
+            // ImGui glyph-range table.
+            switch (extraRange)
+            {
+                case ExtraGlyphRanges.LatinExtended:
+                    customChars.AddRange(ExtraGlyphRangesExt.LatinExtendedPairs);
+                    break;
+                case ExtraGlyphRanges.Greek:
+                    customChars.AddRange(ExtraGlyphRangesExt.GreekPairs);
+                    break;
+                default:
+                    var ptr = extraRange.Range();
+                    if (ptr != 0)
+                        ranges.Add(ptr);
+                    break;
+            }
+        }
+
+        Ranges = BuildRange(customChars.Count > 0 ? customChars : null, ranges.ToArray());
        JpRange = BuildRange(GlyphRangesJapanese.GlyphRanges);
    }

@@ -1,7 +1,7 @@
 <Project Sdk="Dalamud.NET.Sdk/15.0.0">
    <PropertyGroup>
        <!-- Independent versioning; see yaml changelog for upstream Chat 2 base -->
-        <Version>1.5.1</Version>
+        <Version>1.5.4</Version>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>
        <!-- Use lock file to pin exact versions -->
@@ -50,13 +50,13 @@
        </EmbeddedResource>
    </ItemGroup>

-    <!-- Embedded resources: Hellion font (Exo 2, OFL-1.1) + manifest resource -->
+    <!-- Embedded resources: bundled UI font (Inter Light, OFL-1.1) + manifest resource -->
    <ItemGroup>
-        <EmbeddedResource Include="Resources\HellionFont.ttf">
-            <LogicalName>HellionFont.ttf</LogicalName>
+        <EmbeddedResource Include="Resources\Inter-Light.ttf">
+            <LogicalName>Inter-Light.ttf</LogicalName>
        </EmbeddedResource>
-        <EmbeddedResource Include="Resources\HellionFont-OFL.txt">
-            <LogicalName>HellionFont-OFL.txt</LogicalName>
+        <EmbeddedResource Include="Resources\Inter-OFL.txt">
+            <LogicalName>Inter-OFL.txt</LogicalName>
        </EmbeddedResource>
        <EmbeddedResource Include="Resources\Branding\fox-banner.txt">
            <LogicalName>HellionChat.Branding.fox-banner.txt</LogicalName>
@@ -15,8 +15,8 @@ description: |-
    - Per-channel retention with a daily background sweep
    - Retroactive cleanup (Ctrl+Shift confirm)
    - Export to Markdown, JSON or CSV
-    - First-run wizard with three preset profiles
-    - Bilingual UI (EN/DE) with live language switching
+    - First-run wizard with four preset profiles
+    - Multi-language UI (24 locales) with live language switching
    - Own config and database — no shared state with other plugins

    Based on Chat 2 by Infi and Anna (EUPL-1.2).
@@ -35,6 +35,153 @@ tags:
    - Replacement
    - Privacy
 changelog: |-
+    **v1.5.4 — Polish and Motion (2026-05-20)**
+
+    A polish cycle: smoother theme switching, faster theme and tab
+    access, and subtle hover motion. Three P3 items plus an
+    accessibility toggle.
+
+    User-visible:
+
+    - Theme switches now crossfade smoothly over ~300 ms across every
+      Hellion-rendered surface — sidebar, title, buttons, tabs,
+      scrollbar, separators. The window background snaps deliberately
+      so the per-window opacity override from Dalamud's pinning menu
+      stays untouched.
+    - New header quick-picker: a palette button left of the cog opens
+      a compact popup with two sections — every built-in and custom
+      theme, and every tab. The active entry carries a check glyph;
+      clicking another switches without closing the popup.
+    - Sidebar icons ease their opacity on hover, and card-mode message
+      borders highlight per tab while the cursor is over their rows.
+      Framerate-independent, so a stalled Wine frame cannot overshoot
+      the animation.
+    - New "Reduce motion" toggle in Theme & Layout disables the
+      crossfade, the hover animations and the unread-tab pulse for
+      users who prefer a static UI.
+
+    Under the hood:
+
+    - Two pure-helper lerp paths (ThemeAbgrCacheLerp, FrameLerp) with
+      xUnit coverage in the Build Suite, plus a ColourUtil.ApplyAlpha
+      alpha modulator. Two new /xlperf self-test steps pin the
+      crossfade and quick-picker contracts.
+
+    No schema bump, no migration. Migration v17 stays.
+
+    Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
+
+    ---
+
+    **v1.5.3 — Localisation Wave + Bundled-Font Overhaul (2026-05-19)**
+
+    Multi-language pass plus a long-standing first-frame HITCH lands
+    as a side effect of a font-stack rewrite.
+
+    User-visible:
+
+    - 24 selectable UI languages (was 2). Catalan, Czech, Danish,
+      Dutch, English, Finnish, French, German, Greek, Hungarian,
+      Italian, Japanese, Korean, Norsk bokmål, Polish, Portuguese
+      (BR + PT), Romanian, Russian, Spanish, Swedish, Turkish,
+      Ukrainian, Simplified + Traditional Chinese. Sorted by endonym,
+      "None" pinned first. Non-native locales are AI-assisted and
+      flagged for native-speaker review via the Forge Discord.
+    - Bundled Inter Light replaces Exo 2 (SIL OFL 1.1, 343 KB). The
+      Inter font ships Latin Extended-A/B, Greek polytonic and
+      Cyrillic Supplement coverage; NotoSansCjkRegular joins as a
+      third merge layer for Hangul and Simplified-Han glyphs the
+      FFXIV Japanese game font does not ship.
+    - First-frame HITCH dropped from ~74 ms (v1.5.2 baseline that
+      held since v1.4.x) to a median of ~20 ms (5-reload sample
+      17.9-23.6 ms, Linux/Wine). The bundled-font path silently
+      fell back to the FFXIV Axis font for the entire v1.5.x series
+      because of an early-return in the draw loop. The fix that
+      routes RegularFont through draw also lands the defer-pattern
+      win the v1.5.1 cycle was reaching for.
+    - ExtraGlyphRanges auto-activates on language change. Korean,
+      ChineseFull and the two new flags (LatinExtended, Greek) toggle
+      on without a manual visit to Fonts and Colours.
+    - New WarningText under the language dropdown notes FFXIV's
+      chat input only fully supports EN/DE/FR/JA character sets.
+      Other languages render in HellionChat but may garble when
+      typed into in-game chat.
+
+    Under the hood:
+
+    - Three-layer font stack: Inter Light primary, FFXIV
+      JapaneseFont merge 1 for kana/kanji style, NotoSansCjkRegular
+      merge 2 for everything else CJK.
+    - LanguageOverride enum gains ten locales plus three previously
+      commented out (Italian, Korean, Norwegian as `nb`). New
+      values append to the enum so existing config integers stay
+      stable across update.
+    - Crowdin gap closed: four post-sync ChatTwo keys backfilled
+      into 13 legacy locales with per-key AI markers.
+    - Plugin.LoadAsync runs a one-shot migration that ORs in the
+      matching ExtraGlyphRanges flag for users already on a
+      non-default language. Settings.Apply auto-activates on
+      change going forward.
+    - Em-dash sweep across the EN source and 18 translations to the
+      house style. Russian and Ukrainian keep the typographic norm.
+
+    Migration v17 stays. UseHellionFont users transition from Exo 2
+    to Inter Light transparently on first reload.
+
+    Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
+
+    ---
+
+    **v1.5.2 — First-Run Wizard Rework (2026-05-18)**
+
+    UX patch. The first-run wizard becomes a four-step flow with a
+    new Roleplay privacy profile and a power-settings step that
+    surfaces previously-hidden defaults. Existing v1.5.1 users see
+    the new wizard once on first v1.5.2 boot.
+
+    What changes user-visible:
+
+    - Wizard navigation: Welcome → Privacy profile → Power settings
+      → Done. Forge-Bronze pagination dots, dedicated stage for the
+      power settings so they are no longer buried in Settings.
+    - Fourth privacy profile "Roleplay": Privacy-First plus Say and
+      both emote types, with a 30-day window for Say and a 90-day
+      window for emotes. Shout, Yell and Novice Network stay out.
+    - Privacy picker becomes a 2x2 grid. Casual stays the
+      recommended option with a ★ marker.
+    - Power-settings step covers Load Previous Session, Filter
+      Include Previous Sessions, Auto-Tell-Tabs History Preload,
+      Compact Density, Prettier Timestamps and a built-in theme
+      picker. All six map to existing Configuration fields — no new
+      settings introduced.
+    - Staged commit: the wizard only writes to Config on the Finish
+      step. Decide-later or X-close at any point leaves the existing
+      config untouched.
+    - Inline test hint on the done step: "type /tell <Player Name>
+      into chat" surfaces the auto-tell-tab spawn mechanism.
+    - Window starts at 720x480 (was 900x560) and can shrink to
+      600x400; Step 1 keeps the fox banner in a folded TreeNode so
+      the onboarding copy stays primary.
+    - Existing users get the new wizard surfaced once on first boot
+      after the update via the new WizardLastShownVersion config
+      field. Future cycles bump the constant only when the wizard
+      itself changes shape.
+
+    Under the hood:
+
+    - WizardStateSmokeStep added to /xlperf alongside the FontManager
+      and ThemeSwitch self-tests.
+    - Twelve new pure-helper xUnit Facts in the Build Suite cover
+      all four privacy profile sets and their retention overrides.
+
+    Migration v17 stays (no schema bump). The Configuration grows
+    one optional string field (WizardLastShownVersion) which
+    defaults to empty for legacy users.
+
+    Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
+
+    ---
+
    **v1.5.1 — FontAtlas Refactor and Hellion Forge Signature (2026-05-17)**

    Hybrid FontManager refactor plus an embedded provenance mark.
@@ -85,134 +232,4 @@ changelog: |-

    ---

-    **v1.5.0 — DI Foundation and Service Refactor (2026-05-17)**
-
-    Major architecture cycle. The plugin bootstrap moves to a
-    generic-host DI container (Microsoft.Extensions.Hosting +
-    IServiceCollection) modelled on Lightless Sync. Service logging
-    moves from a static Plugin.LogProxy locator to typed
-    Microsoft.Extensions.Logging.ILogger<T> via constructor injection,
-    bridged over Dalamud's IPluginLog by a custom DalamudLogger trio.
-
-    What changes under the hood:
-
-    - 18 instance-class services migrate to ILogger<T> via constructor
-      injection across four slices: data layer (MessageStore,
-      MessageManager, AutoTellTabsService), IPC and integrations
-      (HonorificService, IpcManager, TypingIpc, ExtraChat, the three
-      GameFunctions classes), UI window layer (ChatLogWindow,
-      DbViewer, Popout, three settings tabs), and root (Commands,
-      ThemeRegistry, PayloadHandler).
-    - Plugin.LogProxy stays in place for the eight buckets ctor
-      injection cannot reach: static helpers (EmoteCache,
-      AutoTranslate, MemoryUtil, WrapperUtil), Dalamud-reflected
-      types (Configuration), the Message data class, and instance
-      classes that only log from static methods (FontManager, one
-      GameFunctions site).
-    - Plugin.cs finishes at 1012 lines — virtually identical to the
-      pre-cycle 1013. The new Phase-1 host build and Plugin.X bridge
-      wiring trade out exactly the service and window allocations
-      that previously lived in LoadAsync.
-    - Cross-plugin baseline confirms no performance penalty against
-      Chat 2: HellionChat first-frame HITCH 77 ms median, Chat 2
-      74 ms median. Lightless and XIVInstantMessenger sit around
-      7 ms by deferring their font-atlas build past Finished
-      loading — that pattern is the v1.5.1 follow-up.
-
-    User-visible:
-
-    - Slash-command insert fix: pasting a slash command into the
-      chat input (Friend List "/tell" action, plugin-driven inserts
-      from Artisan, AllaganTools etc.) now replaces the existing
-      input instead of concatenating. Cherry-picked from ChatTwo
-      upstream ee7768ac with namespace adaptation.
-
-    Migration v17 stays (no schema bump).
-
-    Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
-
-    ---
-
-    **v1.4.10 — Symbol-Picker and Tell-History Fix (2026-05-16)**
-
-    Eleventh and final sub-patch of the v1.4.x polish-sweep series.
-    Symbol picker for the chat input, a tell-history reload fix for
-    users with many active partners, and a closing cleanup sweep
-    before v1.5.0 picks up the DI-container adoption.
-
-    - Symbol picker: a small smile-icon button left of the channel
-      indicator opens a popup with two tabs. The first lists all 161
-      FFXIV PUA glyphs (Dalamud's SeIconChar enum); the second
-      carries 97 server-verified BMP symbols (latin marks, currency,
-      the full Greek alphabet, geometric shapes, suits, notes) —
-      every one of them round-tripped through /echo and /say in a
-      four-round probe so the in-channel render matches what the
-      picker shows. Click drops the glyph at the caret, multi-insert
-      keeps the popup open, and a recent-used strip floats the last
-      sixteen picks across both tabs. Toggle in Settings → Chat →
-      Message behaviour, default on.
-    - Pinned auto-tell tabs reload their full history again: a
-      hidden 500-row scan cap in PreloadHistory used to override the
-      user-configurable AutoTellTabsHistoryPreload setting, so
-      less-frequent pinned partners (rare /tell sessions in an
-      otherwise busy week) lost their backlog. The cap is removed;
-      the (Receiver, Date) index keeps SQL fast, the client-side
-      loop still respects your setting as the upper bound.
-    - Slash-command teardown: /hellion, /hellionView,
-      /hellionDebugger (and #if DEBUG /hellionSeString) wrappers are
-      now cached as private fields. Plugin teardown detaches the
-      live registration instead of re-Register'ing with identical
-      args — closes a latent maintenance hazard from v1.4.9.
-    - v1.4.x polish-sweep wraps up here. The ImGuiListClipper render
-      refactor that was on the v1.4.10 reserve list got dropped
-      after cross-platform smoke showed the scroll rubber-band is a
-      Wine / Linux render-pipeline quirk, not universal — Windows
-      users never saw it. It will get its own platform-targeted
-      spike in a later patch. Next major cycle is v1.5.0 with the
-      DI-container adoption (Microsoft.Extensions.Hosting +
-      ILogger<T>) modelled on Lightless.
-    - Migration v17 stays (no schema bump).
-
-    Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
-
-    ---
-
-    **v1.4.9 — Plugin-Load Render Polish (2026-05-15)**
-
-    Tenth sub-patch of the v1.4.x polish-sweep series. First-frame
-    render cost drops from ~127 ms median to ~76 ms median,
-    comfortably under Dalamud's 100 ms HITCH warning threshold.
-
-    - First-frame defer: six non-essential rendering sections inside
-      ChatLogWindow skip their first Draw and run one frame later
-      (bottom status bar, channel-name SeString chunks, window bounds
-      check, v0.6.1 hint banner, autocomplete, input-preview
-      calculation). User-visible delay is ~17 ms at 60 fps, hidden
-      inside the post-reload font-atlas build window.
-    - Slash-command centralisation: /hellion, /hellionView,
-      /hellionSeString and /hellionDebugger are registered in
-      LoadAsync instead of inside the corresponding window
-      constructors. The plugin-manager Open and configuration buttons
-      hang on the same path.
-    - Plugin-load profiling logs stay on at Information level
-      (MessageStore connect/migrate, FilterAllTabs, auto-translate
-      warmup) as a regression tripwire — a future load past 100 ms
-      will show up in /xllog without a Debug filter.
-    - ChatTwo IPC compatibility layer: HellionChat now mirrors
-      ChatTwo's full IPC surface (GetChatInputState,
-      ChatInputStateChanged, Register, Unregister, Available,
-      Invoke) under the ChatTwo.* namespace in addition to our
-      existing HellionChat.* provider gates. Third-party
-      integrations that historically only subscribe to ChatTwo's
-      IPC — for example Artisan's and AllaganTools' context-menu
-      hooks — keep working without requiring a code change on their
-      side. Conflict detection prevents ChatTwo from loading in
-      parallel with HellionChat, so there is no slot-collision risk
-      at runtime.
-    - Migration v17 stays (no schema bump).
-
-    Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
-
-    ---
-
    Full history: https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/releases
@@ -19,7 +19,7 @@ internal sealed class ThemeRegistryInitHostedService(ThemeRegistry registry) : I
        // warm cache; otherwise the first Switch falls through to the built-in
        // default when Config.Theme points at a custom slug.
        foreach (var _ in registry.AllCustom()) { }
-        registry.Switch(Plugin.Config.Theme);
+        registry.SwitchSilent(Plugin.Config.Theme);
        return Task.CompletedTask;
    }

@@ -216,6 +216,17 @@ public sealed class Plugin : IAsyncDalamudPlugin
        Config.Tabs.RemoveAll(TabLifecycleHelpers.ShouldStripOnLoad);

        LanguageChanged(Interface.UiLanguage);
+
+        // v1.5.3 migration: Settings.Apply auto-activates the matching
+        // ExtraGlyphRanges flag on a language CHANGE; a config that already
+        // has e.g. Czech selected from a previous version never goes through
+        // that path. ORing in the required flag here lets the first atlas
+        // build pick it up, so an upgrade from v1.5.2 renders correctly
+        // without forcing the user to toggle the language twice.
+        var requiredRanges = Config.LanguageOverride.RequiredGlyphRanges();
+        if (requiredRanges != 0 && !Config.ExtraGlyphRanges.HasFlag(requiredRanges))
+            Config.ExtraGlyphRanges |= requiredRanges;
+
        ImGuiUtil.Initialize(this);

        DeferredSaveFrames = -1;
@@ -319,10 +330,26 @@ public sealed class Plugin : IAsyncDalamudPlugin

            SelfTestRegistry.RegisterTestSteps([
                new SelfTests.ThemeSwitchSelfTestStep(this),
+                new SelfTests.ThemeCrossfadeSelfTestStep(this),
                new SelfTests.FontManagerCtorSmokeStep(this),
                new SelfTests.FontPushSmokeStep(this),
+                new SelfTests.WizardStateSmokeStep(this),
+                new SelfTests.QuickPickerSelfTestStep(this),
            ]);

+            // Re-surface the wizard for existing users when a major UX
+            // rework ships. The constant tracks the most recent version
+            // whose wizard should be shown once; bump it in future cycles
+            // that reshape the onboarding flow. Saved immediately so a
+            // pre-Finish crash doesn't loop the prompt forever.
+            const string WizardReshowVersion = "1.5.2";
+            if (Config.WizardLastShownVersion != WizardReshowVersion)
+            {
+                Config.FirstRunCompleted = false;
+                Config.WizardLastShownVersion = WizardReshowVersion;
+                SaveConfig();
+            }
+
            if (!Config.FirstRunCompleted)
                FirstRunWizard.IsOpen = true;

@@ -887,6 +914,7 @@ public sealed class Plugin : IAsyncDalamudPlugin
        // Theme engine is always active; Classic is a theme, not a disabled state.
        using IDisposable _style = HellionStyle.PushGlobal(
            ThemeRegistry.Active,
+            ThemeRegistry,
            Config.WindowOpacity
        );

@@ -920,7 +948,12 @@ public sealed class Plugin : IAsyncDalamudPlugin
        // RegularFont is nullable only because the live rebuild path
        // disposes it before reassigning; both ends of that swap happen on
        // this same draw thread, so it cannot be null here.
-        using ((Config.FontsEnabled ? FontManager.RegularFont! : FontManager.Axis).Push())
+        // v1.5.3 fix: also push RegularFont when the bundled Inter Light is
+        // selected. Without this, UseHellionFont=true silently fell back to
+        // the FFXIV Axis font because FontsAndColours forces FontsEnabled
+        // off in that branch, and the bundled font never made it into draw.
+        var useRegularFont = Config.FontsEnabled || Config.UseHellionFont;
+        using ((useRegularFont ? FontManager.RegularFont! : FontManager.Axis).Push())
            WindowSystem.Draw();

        ChatLogWindow.FinalizeFrame();
@@ -114,4 +114,29 @@ internal static class PrivacyDefaults
            [ChatType.StandardEmote] = 1,
            [ChatType.NoviceNetwork] = 1,
        };
+
+    // Roleplay: Privacy-First + Say + both emote types. Public-distance
+    // channels (Shout, Yell) stay out — they are public-noise from
+    // strangers, not story content. Novice Network also stays out;
+    // it is not RP-adjacent and would dilute the profile's intent.
+    internal static readonly IReadOnlySet<ChatType> RoleplayWhitelist = new HashSet<ChatType>(
+        PrivacyFirstWhitelist
+    )
+    {
+        ChatType.Say,
+        ChatType.CustomEmote,
+        ChatType.StandardEmote,
+    };
+
+    // RP sessions function as story logs: Say + emotes need a longer
+    // window than Casual's 1-day public-chat window. 30 days for Say
+    // keeps in-character dialogue scrollable across multiple sessions,
+    // 90 days for emotes mirrors the Privacy-First conversation default.
+    internal static readonly IReadOnlyDictionary<ChatType, int> RoleplayRetentionOverrides =
+        new Dictionary<ChatType, int>
+        {
+            [ChatType.Say] = 30,
+            [ChatType.CustomEmote] = 90,
+            [ChatType.StandardEmote] = 90,
+        };
 }
@@ -116,6 +116,38 @@ internal class HellionStrings
    internal static string Wizard_Reopen_Button => Get(nameof(Wizard_Reopen_Button));
    internal static string Wizard_Cancel_Label => Get(nameof(Wizard_Cancel_Label));
    internal static string Wizard_Cancel_Tooltip => Get(nameof(Wizard_Cancel_Tooltip));
+    internal static string Wizard_Step1_Title => Get(nameof(Wizard_Step1_Title));
+    internal static string Wizard_Step1_Subtitle => Get(nameof(Wizard_Step1_Subtitle));
+    internal static string Wizard_Step1_Footer_Hint => Get(nameof(Wizard_Step1_Footer_Hint));
+    internal static string Wizard_Step1_Skip_Label => Get(nameof(Wizard_Step1_Skip_Label));
+    internal static string Wizard_Step1_Skip_Tooltip => Get(nameof(Wizard_Step1_Skip_Tooltip));
+    internal static string Wizard_Step2_Title => Get(nameof(Wizard_Step2_Title));
+    internal static string Wizard_Step2_RecommendedFooter => Get(nameof(Wizard_Step2_RecommendedFooter));
+    internal static string Wizard_Profile_Roleplay_Heading => Get(nameof(Wizard_Profile_Roleplay_Heading));
+    internal static string Wizard_Profile_Roleplay_Description => Get(nameof(Wizard_Profile_Roleplay_Description));
+    internal static string Wizard_Profile_Roleplay_Apply => Get(nameof(Wizard_Profile_Roleplay_Apply));
+    internal static string Wizard_Nav_Back => Get(nameof(Wizard_Nav_Back));
+    internal static string Wizard_Nav_Next => Get(nameof(Wizard_Nav_Next));
+    internal static string Wizard_Nav_Finish => Get(nameof(Wizard_Nav_Finish));
+    internal static string Wizard_Step3_Title => Get(nameof(Wizard_Step3_Title));
+    internal static string Wizard_Step3_Section_History => Get(nameof(Wizard_Step3_Section_History));
+    internal static string Wizard_Step3_Section_TellTabs => Get(nameof(Wizard_Step3_Section_TellTabs));
+    internal static string Wizard_Step3_Section_Visual => Get(nameof(Wizard_Step3_Section_Visual));
+    internal static string Wizard_Step3_LoadPreviousSession_Label => Get(nameof(Wizard_Step3_LoadPreviousSession_Label));
+    internal static string Wizard_Step3_FilterIncludePreviousSessions_Label => Get(nameof(Wizard_Step3_FilterIncludePreviousSessions_Label));
+    internal static string Wizard_Step3_AutoTellTabsHistoryPreload_Label => Get(nameof(Wizard_Step3_AutoTellTabsHistoryPreload_Label));
+    internal static string Wizard_Step3_UseCompactDensity_Label => Get(nameof(Wizard_Step3_UseCompactDensity_Label));
+    internal static string Wizard_Step3_PrettierTimestamps_Label => Get(nameof(Wizard_Step3_PrettierTimestamps_Label));
+    internal static string Wizard_Step3_Theme_Label => Get(nameof(Wizard_Step3_Theme_Label));
+    internal static string Wizard_Step4_Title => Get(nameof(Wizard_Step4_Title));
+    internal static string Wizard_Step4_SummaryHeading => Get(nameof(Wizard_Step4_SummaryHeading));
+    internal static string Wizard_Step4_Summary_Profile => Get(nameof(Wizard_Step4_Summary_Profile));
+    internal static string Wizard_Step4_Summary_History => Get(nameof(Wizard_Step4_Summary_History));
+    internal static string Wizard_Step4_Summary_TellTabs => Get(nameof(Wizard_Step4_Summary_TellTabs));
+    internal static string Wizard_Step4_Summary_Visual => Get(nameof(Wizard_Step4_Summary_Visual));
+    internal static string Wizard_Step4_Summary_Unchanged => Get(nameof(Wizard_Step4_Summary_Unchanged));
+    internal static string Wizard_Step4_TestHint => Get(nameof(Wizard_Step4_TestHint));
+    internal static string Wizard_Step4_SettingsHint => Get(nameof(Wizard_Step4_SettingsHint));

    internal static string Export_Heading => Get(nameof(Export_Heading));
    internal static string Export_Help => Get(nameof(Export_Help));
@@ -251,6 +283,7 @@ internal class HellionStrings
    internal static string Settings_General_Audio_Heading => Get(nameof(Settings_General_Audio_Heading));
    internal static string Settings_General_Performance_Heading => Get(nameof(Settings_General_Performance_Heading));
    internal static string Settings_General_Language_Heading => Get(nameof(Settings_General_Language_Heading));
+    internal static string Settings_Language_FFXIVCoverage_Warning => Get(nameof(Settings_Language_FFXIVCoverage_Warning));

    // Hellion Chat — Appearance-Tab section headings
    internal static string Settings_Appearance_Theme_Heading => Get(nameof(Settings_Appearance_Theme_Heading));
@@ -411,4 +444,11 @@ internal class HellionStrings
    internal static string DbViewer_FullTextToggle => Get(nameof(DbViewer_FullTextToggle));
    internal static string DbViewer_FullTextToggle_Hint_Indexing => Get(nameof(DbViewer_FullTextToggle_Hint_Indexing));
    internal static string DbViewer_FullTextToggle_Hint_PhraseMode => Get(nameof(DbViewer_FullTextToggle_Hint_PhraseMode));
+
+    // Hellion Chat — v1.5.4 header quick-picker + reduce-motion toggle
+    internal static string Settings_QuickPicker_Tooltip => Get(nameof(Settings_QuickPicker_Tooltip));
+    internal static string Settings_QuickPicker_Themes_Header => Get(nameof(Settings_QuickPicker_Themes_Header));
+    internal static string Settings_QuickPicker_Tabs_Header => Get(nameof(Settings_QuickPicker_Tabs_Header));
+    internal static string Settings_ThemeAndLayout_ReduceMotion_Name => Get(nameof(Settings_ThemeAndLayout_ReduceMotion_Name));
+    internal static string Settings_ThemeAndLayout_ReduceMotion_Description => Get(nameof(Settings_ThemeAndLayout_ReduceMotion_Description));
 }
@@ -223,11 +223,107 @@
    <value>Wizard erneut zeigen</value>
  </data>
  <data name="Wizard_Cancel_Label" xml:space="preserve">
-    <value>Später — Defaults behalten</value>
+    <value>Später: Defaults behalten</value>
  </data>
  <data name="Wizard_Cancel_Tooltip" xml:space="preserve">
    <value>Schließt den Wizard ohne Profil-Auswahl. Die Plugin-Defaults bleiben aktiv und der Wizard erscheint beim nächsten Plugin-Reload erneut.</value>
  </data>
+  <data name="Wizard_Step1_Title" xml:space="preserve">
+    <value>Willkommen bei Hellion Chat</value>
+  </data>
+  <data name="Wizard_Step1_Subtitle" xml:space="preserve">
+    <value>Ein Chat 2 Fork von Hellion Forge mit DSGVO-konformen Defaults, brand-konsistentem Look und Quality-of-Life-Verbesserungen.</value>
+  </data>
+  <data name="Wizard_Step1_Footer_Hint" xml:space="preserve">
+    <value>3 kurze Schritte. Du kannst alles später unter Einstellungen → Hellion Chat ändern.</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Label" xml:space="preserve">
+    <value>Später entscheiden</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Tooltip" xml:space="preserve">
+    <value>Assistenten schließen. Die Plugin-Standardwerte bleiben aktiv. Du kannst den Assistenten über Einstellungen → Hellion Chat erneut öffnen.</value>
+  </data>
+  <data name="Wizard_Step2_Title" xml:space="preserve">
+    <value>Was darf gespeichert werden?</value>
+  </data>
+  <data name="Wizard_Step2_RecommendedFooter" xml:space="preserve">
+    <value>★ = empfohlen für die meisten Spieler.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Heading" xml:space="preserve">
+    <value>Roleplay</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Description" xml:space="preserve">
+    <value>Wie Datensparsamkeit, plus Sagen und beide Emote-Typen für deine Story-Logs. Schreien und Rufen bleiben außen vor. Public-Distance-Lärm von Fremden ist kein Story-Inhalt. Aufbewahrung: Sagen 30 Tage, Emotes 90 Tage.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Apply" xml:space="preserve">
+    <value>Roleplay übernehmen</value>
+  </data>
+  <data name="Wizard_Nav_Back" xml:space="preserve">
+    <value>‹ Zurück</value>
+  </data>
+  <data name="Wizard_Nav_Next" xml:space="preserve">
+    <value>Weiter ›</value>
+  </data>
+  <data name="Wizard_Nav_Finish" xml:space="preserve">
+    <value>Fertig ✓</value>
+  </data>
+  <data name="Wizard_Step3_Title" xml:space="preserve">
+    <value>Versteckte Defaults</value>
+  </data>
+  <data name="Wizard_Step3_Section_History" xml:space="preserve">
+    <value>Verlauf</value>
+  </data>
+  <data name="Wizard_Step3_Section_TellTabs" xml:space="preserve">
+    <value>Tell-Tabs</value>
+  </data>
+  <data name="Wizard_Step3_Section_Visual" xml:space="preserve">
+    <value>Optik</value>
+  </data>
+  <data name="Wizard_Step3_LoadPreviousSession_Label" xml:space="preserve">
+    <value>Vorherige Session beim Start laden</value>
+  </data>
+  <data name="Wizard_Step3_FilterIncludePreviousSessions_Label" xml:space="preserve">
+    <value>Filter auch auf alte Messages anwenden</value>
+  </data>
+  <data name="Wizard_Step3_AutoTellTabsHistoryPreload_Label" xml:space="preserve">
+    <value>N Tell-Messages beim Öffnen eines Auto-Tabs vorladen</value>
+  </data>
+  <data name="Wizard_Step3_UseCompactDensity_Label" xml:space="preserve">
+    <value>Kompakter Density-Modus</value>
+  </data>
+  <data name="Wizard_Step3_PrettierTimestamps_Label" xml:space="preserve">
+    <value>Schönere Timestamps (relative Zeit)</value>
+  </data>
+  <data name="Wizard_Step3_Theme_Label" xml:space="preserve">
+    <value>Theme</value>
+  </data>
+  <data name="Wizard_Step4_Title" xml:space="preserve">
+    <value>Du bist startklar</value>
+  </data>
+  <data name="Wizard_Step4_SummaryHeading" xml:space="preserve">
+    <value>Deine Konfiguration</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Profile" xml:space="preserve">
+    <value>Profil: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_History" xml:space="preserve">
+    <value>Verlauf: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_TellTabs" xml:space="preserve">
+    <value>Tell-Tabs: {0} Messages vorladen</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Visual" xml:space="preserve">
+    <value>Optik: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Unchanged" xml:space="preserve">
+    <value>(unverändert)</value>
+  </data>
+  <data name="Wizard_Step4_TestHint" xml:space="preserve">
+    <value>💡 Probier's aus: Tipp /tell &lt;Spielername&gt; in den Chat. Hellion Chat öffnet automatisch einen eigenen Tab für die Unterhaltung und lädt die letzten {0} Messages mit.</value>
+  </data>
+  <data name="Wizard_Step4_SettingsHint" xml:space="preserve">
+    <value>Einstellungen → Hellion Chat zum späteren Anpassen</value>
+  </data>
  <data name="Export_Heading" xml:space="preserve">
    <value>Export (DSGVO Art. 15 — Auskunftsrecht)</value>
  </data>
@@ -289,10 +385,10 @@
    <value>Wie deckend die Plugin-Fenster sind. Niedrigere Werte lassen das Spiel durchscheinen, Form-Felder und Dialoge bleiben oben drauf deckend und gut lesbar.</value>
  </data>
  <data name="Theme_UseHellionFont_Name" xml:space="preserve">
-    <value>Mitgelieferte Hellion-Schrift (Exo 2) verwenden</value>
+    <value>Mitgelieferte Inter Light verwenden</value>
  </data>
  <data name="Theme_UseHellionFont_Description" xml:space="preserve">
-    <value>Rendert Chat und UI in Exo 2 (SIL Open Font License 1.1), die mit dem Plugin ausgeliefert wird. Deaktivieren, um auf die unter Einstellungen → Schrift gewählte Schriftart zurückzufallen.</value>
+    <value>Stellt Chat und UI in Inter Light (SIL Open Font License 1.1) dar, die mit dem Plugin geliefert wird. Deaktivieren, um zur Schrift aus Einstellungen → Schriftart zurückzukehren.</value>
  </data>

  <data name="About_Maintainer_Heading" xml:space="preserve">
@@ -399,7 +495,7 @@
    <value>Maximal {0} angepinnte Tell-Tabs erreicht. Erst einen lösen oder dauerhaft behalten.</value>
  </data>
  <data name="PinTab_PinnedTooltip" xml:space="preserve">
-    <value>Angepinnt — überlebt Relog.</value>
+    <value>Angepinnt: überlebt Relog.</value>
  </data>
  <data name="PinTab_PinTooltip" xml:space="preserve">
    <value>Angepinnte Tabs überleben Relog und behalten die Bindung an die Tell-Person.</value>
@@ -440,7 +536,7 @@
    <value>„Als begrüßt markieren"-Button anzeigen</value>
  </data>
  <data name="ChatLog_AutoTellTabs_GreetedToggle_Description" xml:space="preserve">
-    <value>Fügt neben jedem Auto-Tell-Tab einen Klick-Button hinzu, um einen Gesprächspartner als bereits begrüßt zu markieren — der Tab-Name wird dann gedimmt. Nützlich für Club-Greeter, die parallel viele Konversationen führen. Standardmäßig aus.</value>
+    <value>Fügt neben jedem Auto-Tell-Tab einen Klick-Button hinzu, um einen Gesprächspartner als bereits begrüßt zu markieren: der Tab-Name wird dann gedimmt. Nützlich für Club-Greeter, die parallel viele Konversationen führen. Standardmäßig aus.</value>
  </data>
  <data name="ChatLog_AutoTellTabs_OpenAsPopout_Name" xml:space="preserve">
    <value>Neue /tell-Tabs direkt als Pop-Out öffnen</value>
@@ -809,7 +905,7 @@
    <value>Fenster-Transparenz</value>
  </data>
  <data name="Settings_ThemeAndLayout_WindowOpacity_Description" xml:space="preserve">
-    <value>Wie durchsichtig der Fensterhintergrund ist. Niedrigere Werte lassen mehr vom Spiel durchscheinen. Tipp: Dalamud's Per-Window-Menü (Hamburger in der Titelleiste) bietet pro Fenster eigene Overrides für Deckkraft, Hintergrund-Blur, Durchklick und Anpinnen — die haben Vorrang über diesen Slider für das jeweilige Fenster.</value>
+    <value>Wie durchsichtig der Fensterhintergrund ist. Niedrigere Werte lassen mehr vom Spiel durchscheinen. Tipp: Dalamud's Per-Window-Menü (Hamburger in der Titelleiste) bietet pro Fenster eigene Overrides für Deckkraft, Hintergrund-Blur, Durchklick und Anpinnen: die haben Vorrang über diesen Slider für das jeweilige Fenster.</value>
  </data>
  <data name="Settings_FontsAndColours_Fonts_Heading" xml:space="preserve">
    <value>Schriftarten</value>
@@ -934,4 +1030,22 @@
  <data name="DbViewer_FullTextToggle_Hint_PhraseMode" xml:space="preserve">
    <value>Sucht nach der exakten Wortfolge. Mehrere Wörter werden nur gefunden, wenn sie zusammen und in dieser Reihenfolge stehen. Wer rohe FTS5-MATCH-Syntax nutzen will, setzt eigene Anführungszeichen um den Suchbegriff.</value>
  </data>
+  <data name="Settings_Language_FFXIVCoverage_Warning" xml:space="preserve">
+    <value>HellionChat zeigt alle 24 Sprachen, aber FFXIVs Chat-Eingabe unterstützt nur EN, DE, FR und JA vollständig. Andere Schriften können beim Tippen in den Spiel-Chat oder beim Senden von Nachrichten als unleserliche Zeichen erscheinen.</value>
+  </data>
+  <data name="Settings_QuickPicker_Tooltip" xml:space="preserve">
+    <value>Schnellauswahl für Themes und Tabs</value>
+  </data>
+  <data name="Settings_QuickPicker_Themes_Header" xml:space="preserve">
+    <value>Themes</value>
+  </data>
+  <data name="Settings_QuickPicker_Tabs_Header" xml:space="preserve">
+    <value>Tabs</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Name" xml:space="preserve">
+    <value>Bewegung reduzieren</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Description" xml:space="preserve">
+    <value>Deaktiviert die Theme-Überblendung, die Hover-Animationen von Seitenleiste und Karten sowie das Pulsieren ungelesener Tabs. Theme-Wechsel und Hover-Zustände greifen dann sofort.</value>
+  </data>
 </root>
@@ -19,7 +19,7 @@
    <value>Enable privacy filter</value>
  </data>
  <data name="Privacy_FilterEnabled_Description" xml:space="preserve">
-    <value>When enabled, only messages from allowed channels are written to the database. When disabled, the default behaviour applies — everything except battle logs is stored.</value>
+    <value>When enabled, only messages from allowed channels are written to the database. When disabled, the default behaviour applies. Everything except battle logs is stored.</value>
  </data>
  <data name="Privacy_FilterEnabled_StorageOnly_Help" xml:space="preserve">
    <value>The filter only controls what is written to the local database. The chat log still shows every message live; excluded channels are simply no longer stored. If you also want to remove channels from the visible display, use the normal chat-tab filters in the game.</value>
@@ -82,7 +82,7 @@
    <value>The manual run uses your SAVED retention policy, not the slider values above. Click Save first if you want the run to apply your current changes.</value>
  </data>
  <data name="Cleanup_Preview_Stale" xml:space="preserve">
-    <value>Preview is stale — your whitelist has changed since the last refresh. Click Refresh to recalculate.</value>
+    <value>Preview is stale: your whitelist has changed since the last refresh. Click Refresh to recalculate.</value>
  </data>
  <data name="Cleanup_RefreshPreview" xml:space="preserve">
    <value>Refresh preview</value>
@@ -133,7 +133,7 @@
    <value>Automatically delete messages past their channel retention window</value>
  </data>
  <data name="Retention_Enabled_Description" xml:space="preserve">
-    <value>When enabled, messages older than the configured window are deleted on each plugin start (at most once every 24 hours). Default is OFF — the plugin never deletes anything without your explicit consent.</value>
+    <value>When enabled, messages older than the configured window are deleted on each plugin start (at most once every 24 hours). Default is OFF. The plugin never deletes anything without your explicit consent.</value>
  </data>
  <data name="Retention_Default_Label" xml:space="preserve">
    <value>Default retention (days, 0 = never)</value>
@@ -223,11 +223,107 @@
    <value>Show wizard again</value>
  </data>
  <data name="Wizard_Cancel_Label" xml:space="preserve">
-    <value>Later — keep defaults</value>
+    <value>Later: keep defaults</value>
  </data>
  <data name="Wizard_Cancel_Tooltip" xml:space="preserve">
    <value>Close the wizard without selecting a profile. The plugin defaults stay active and the wizard returns on next plugin load.</value>
  </data>
+  <data name="Wizard_Step1_Title" xml:space="preserve">
+    <value>Welcome to Hellion Chat</value>
+  </data>
+  <data name="Wizard_Step1_Subtitle" xml:space="preserve">
+    <value>A Chat 2 fork from Hellion Forge with privacy-aware defaults, brand-consistent visuals, and a few quality-of-life touches.</value>
+  </data>
+  <data name="Wizard_Step1_Footer_Hint" xml:space="preserve">
+    <value>Three short steps. You can change everything later under Settings → Hellion Chat.</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Label" xml:space="preserve">
+    <value>Decide later</value>
+  </data>
+  <data name="Wizard_Step1_Skip_Tooltip" xml:space="preserve">
+    <value>Close the wizard. The plugin defaults stay active. You can reopen the wizard from Settings → Hellion Chat.</value>
+  </data>
+  <data name="Wizard_Step2_Title" xml:space="preserve">
+    <value>What gets stored?</value>
+  </data>
+  <data name="Wizard_Step2_RecommendedFooter" xml:space="preserve">
+    <value>★ = recommended for most players.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Heading" xml:space="preserve">
+    <value>Roleplay</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Description" xml:space="preserve">
+    <value>Like Privacy First, plus Say and both emote types for your story logs. Shout and Yell stay out. Public-distance noise from strangers is not story content. Retention: Say 30 days, emotes 90 days.</value>
+  </data>
+  <data name="Wizard_Profile_Roleplay_Apply" xml:space="preserve">
+    <value>Apply roleplay</value>
+  </data>
+  <data name="Wizard_Nav_Back" xml:space="preserve">
+    <value>‹ Back</value>
+  </data>
+  <data name="Wizard_Nav_Next" xml:space="preserve">
+    <value>Next ›</value>
+  </data>
+  <data name="Wizard_Nav_Finish" xml:space="preserve">
+    <value>Finish ✓</value>
+  </data>
+  <data name="Wizard_Step3_Title" xml:space="preserve">
+    <value>Hidden defaults</value>
+  </data>
+  <data name="Wizard_Step3_Section_History" xml:space="preserve">
+    <value>History</value>
+  </data>
+  <data name="Wizard_Step3_Section_TellTabs" xml:space="preserve">
+    <value>Tell tabs</value>
+  </data>
+  <data name="Wizard_Step3_Section_Visual" xml:space="preserve">
+    <value>Visual</value>
+  </data>
+  <data name="Wizard_Step3_LoadPreviousSession_Label" xml:space="preserve">
+    <value>Load previous session on startup</value>
+  </data>
+  <data name="Wizard_Step3_FilterIncludePreviousSessions_Label" xml:space="preserve">
+    <value>Apply filters to messages from previous sessions</value>
+  </data>
+  <data name="Wizard_Step3_AutoTellTabsHistoryPreload_Label" xml:space="preserve">
+    <value>Preload N tell messages when an auto-tab opens</value>
+  </data>
+  <data name="Wizard_Step3_UseCompactDensity_Label" xml:space="preserve">
+    <value>Compact density</value>
+  </data>
+  <data name="Wizard_Step3_PrettierTimestamps_Label" xml:space="preserve">
+    <value>Prettier timestamps (relative time)</value>
+  </data>
+  <data name="Wizard_Step3_Theme_Label" xml:space="preserve">
+    <value>Theme</value>
+  </data>
+  <data name="Wizard_Step4_Title" xml:space="preserve">
+    <value>You're all set</value>
+  </data>
+  <data name="Wizard_Step4_SummaryHeading" xml:space="preserve">
+    <value>Your configuration</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Profile" xml:space="preserve">
+    <value>Profile: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_History" xml:space="preserve">
+    <value>History: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_TellTabs" xml:space="preserve">
+    <value>Tell tabs: preload {0} messages</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Visual" xml:space="preserve">
+    <value>Visual: {0}</value>
+  </data>
+  <data name="Wizard_Step4_Summary_Unchanged" xml:space="preserve">
+    <value>(unchanged)</value>
+  </data>
+  <data name="Wizard_Step4_TestHint" xml:space="preserve">
+    <value>💡 Try it: type /tell &lt;Player Name&gt; into chat. Hellion Chat opens a dedicated tab for the conversation and preloads the last {0} messages.</value>
+  </data>
+  <data name="Wizard_Step4_SettingsHint" xml:space="preserve">
+    <value>Settings → Hellion Chat to fine-tune later</value>
+  </data>
  <data name="Export_Heading" xml:space="preserve">
    <value>Export (GDPR Art. 15 — Right of access)</value>
  </data>
@@ -289,10 +385,10 @@
    <value>How opaque the plugin windows are. Lower values let the game show through; form fields and dialogs stay fully opaque and readable on top.</value>
  </data>
  <data name="Theme_UseHellionFont_Name" xml:space="preserve">
-    <value>Use bundled Hellion font (Exo 2)</value>
+    <value>Use bundled Inter Light</value>
  </data>
  <data name="Theme_UseHellionFont_Description" xml:space="preserve">
-    <value>Renders chat and UI in Exo 2 (SIL Open Font License 1.1), which ships with the plugin. Disable to fall back to the font selected under Settings → Font.</value>
+    <value>Renders chat and UI in Inter Light (SIL Open Font License 1.1), which ships with the plugin. Disable to fall back to the font selected under Settings → Font.</value>
  </data>

  <data name="About_Maintainer_Heading" xml:space="preserve">
@@ -325,7 +421,7 @@
    <value>Hellion Chat is a fork of Chat 2 by Infi and Anna (ascclemens). The chat-replacement window, IPC integration, render engine, and the entire storage core all come from the original.</value>
  </data>
  <data name="About_BuiltOn_P2" xml:space="preserve">
-    <value>The web interface is the only major piece I removed. It is built for remote access to the chat from a second device — a different focus from the smaller default footprint this fork pursues. Adapting it to these defaults would have required significant rework, so removing it was the clean path for this particular fork.</value>
+    <value>The web interface is the only major piece I removed. It is built for remote access to the chat from a second device: a different focus from the smaller default footprint this fork pursues. Adapting it to these defaults would have required significant rework, so removing it was the clean path for this particular fork.</value>
  </data>
  <data name="About_BuiltOn_Upstream_Label" xml:space="preserve">
    <value>Upstream repository:</value>
@@ -393,7 +489,7 @@
    <value>Promote to permanent</value>
  </data>
  <data name="PinTab_PromoteTooltip" xml:space="preserve">
-    <value>Turns this TempTell into a regular tab. The tell binding to the partner is dropped — the tab will catch messages by its channel filters from now on. For "tab survives relog while staying bound to this partner", use Pin Tab instead.</value>
+    <value>Turns this TempTell into a regular tab. The tell binding to the partner is dropped. The tab will catch messages by its channel filters from now on. For "tab survives relog while staying bound to this partner", use Pin Tab instead.</value>
  </data>
  <data name="PinTab_PinTooltip" xml:space="preserve">
    <value>Pinned tabs survive relog and stay bound to this conversation partner.</value>
@@ -411,7 +507,7 @@
    <value>Maximum of {0} pinned tell tabs reached. Unpin one first, or use Promote to permanent.</value>
  </data>
  <data name="PinTab_PinnedTooltip" xml:space="preserve">
-    <value>Pinned — survives relog.</value>
+    <value>Pinned: survives relog.</value>
  </data>

  <!-- Hellion Chat — Auto-Tell-Tabs (Chat settings tab) -->
@@ -440,7 +536,7 @@
    <value>Show "Mark as greeted" button</value>
  </data>
  <data name="ChatLog_AutoTellTabs_GreetedToggle_Description" xml:space="preserve">
-    <value>Adds a click button next to each auto-tell tab to mark a conversation partner as already greeted — the tab name is then dimmed. Useful for club greeters managing many conversations in parallel. Off by default.</value>
+    <value>Adds a click button next to each auto-tell tab to mark a conversation partner as already greeted. The tab name is then dimmed. Useful for club greeters managing many conversations in parallel. Off by default.</value>
  </data>
  <data name="ChatLog_AutoTellTabs_OpenAsPopout_Name" xml:space="preserve">
    <value>Open new /tell tabs directly as pop-outs</value>
@@ -809,7 +905,7 @@
    <value>Window transparency</value>
  </data>
  <data name="Settings_ThemeAndLayout_WindowOpacity_Description" xml:space="preserve">
-    <value>How transparent the window background is. Lower values let more of the game show through. Tip: Dalamud's per-window menu (hamburger in the title bar) offers per-window overrides for opacity, background blur, click-through, and pinning — those take precedence over this slider for the respective window.</value>
+    <value>How transparent the window background is. Lower values let more of the game show through. Tip: Dalamud's per-window menu (hamburger in the title bar) offers per-window overrides for opacity, background blur, click-through, and pinning. Those take precedence over this slider for the respective window.</value>
  </data>
  <data name="Settings_FontsAndColours_Fonts_Heading" xml:space="preserve">
    <value>Fonts</value>
@@ -934,4 +1030,22 @@
  <data name="DbViewer_FullTextToggle_Hint_PhraseMode" xml:space="preserve">
    <value>Searches for the exact phrase. Multi-word queries match only when the words appear together in order. To use raw FTS5 MATCH syntax, wrap your term in double quotes yourself.</value>
  </data>
+  <data name="Settings_Language_FFXIVCoverage_Warning" xml:space="preserve">
+    <value>HellionChat renders all 24 languages, but FFXIV's chat input only fully supports EN, DE, FR and JA. Other scripts may display as garbled characters when typed into the in-game chat or sent as messages.</value>
+  </data>
+  <data name="Settings_QuickPicker_Tooltip" xml:space="preserve">
+    <value>Quick picker for themes and tabs</value>
+  </data>
+  <data name="Settings_QuickPicker_Themes_Header" xml:space="preserve">
+    <value>Themes</value>
+  </data>
+  <data name="Settings_QuickPicker_Tabs_Header" xml:space="preserve">
+    <value>Tabs</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Name" xml:space="preserve">
+    <value>Reduce motion</value>
+  </data>
+  <data name="Settings_ThemeAndLayout_ReduceMotion_Description" xml:space="preserve">
+    <value>Disables the theme crossfade, the sidebar and card-row hover animations, and the unread-tab pulse. Theme switches and hover states apply instantly instead.</value>
+  </data>
 </root>
@@ -1,93 +1,93 @@
-Copyright 2013 The Exo 2 Project Authors (https://github.com/googlefonts/Exo-2.0)
-
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
-https://openfontlicense.org
-
-
-----------------------------------------------------------
-SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
-----------------------------------------------------------
-
-PREAMBLE
-The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
-with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded, 
-redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
-
-DEFINITIONS
-"Font Software" refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
-
-"Reserved Font Name" refers to any names specified as such after the
-copyright statement(s).
-
-"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-"Modified Version" refers to any derivative made by adding to, deleting,
-or substituting -- in part or in whole -- any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
-new environment.
-
-"Author" refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
-
-PERMISSION & CONDITIONS
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
-
-1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
-
-5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
-using the Font Software.
-
-TERMINATION
-This license becomes null and void if any of the above conditions are
-not met.
-
-DISCLAIMER
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
-OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
-OTHER DEALINGS IN THE FONT SOFTWARE.
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -1859,7 +1859,25 @@ namespace HellionChat.Resources {
                return ResourceManager.GetString("ExtraGlyphRanges_Vietnamese_Name", resourceCulture);
            }
        }
-        
+
+        /// <summary>
+        ///   Looks up a localized string similar to Latin Extended.
+        /// </summary>
+        internal static string ExtraGlyphRanges_LatinExtended_Name {
+            get {
+                return ResourceManager.GetString("ExtraGlyphRanges_LatinExtended_Name", resourceCulture);
+            }
+        }
+
+        /// <summary>
+        ///   Looks up a localized string similar to Greek.
+        /// </summary>
+        internal static string ExtraGlyphRanges_Greek_Name {
+            get {
+                return ResourceManager.GetString("ExtraGlyphRanges_Greek_Name", resourceCulture);
+            }
+        }
+
        /// <summary>
        ///   Looks up a localized string similar to Pick a folder location for export..
        /// </summary>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Tenyeix el selector de canal amb el color del canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>El botó selector de canal al costat del camp d'entrada es tenyeix amb el color del canal actiu. Coincideix amb la tonalitat del text d'entrada.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Amaga mentre el menú New Game+ estigui obert</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Amaga el xat mentre el menú New Game+ estigui obert. En tancar el menú, el xat torna a aparèixer.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Llatí estès</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grec</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1,4 +1,18 @@
 <?xml version="1.0" encoding="utf-8"?>
+<!--
+  Language.de.resx — Hellion Forge maintainer-extended translation
+
+  Locale:      de (German)
+  Maintainer:  Hellion Forge / Hellion Online Media
+  Status:      Native-speaker maintained
+  Review:      Continuous (native maintainer)
+
+  Hellion Forge maintains this file with native-speaker quality,
+  including the keys post-dating the last upstream Chat 2 Crowdin sync.
+
+  Corrections welcome via the Hellion Forge Discord:
+  https://discord.gg/X9V7Kcv5gR
+-->
 <root>
  <!--
      Microsoft ResX Schema
@@ -1481,4 +1495,10 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latein erweitert</value>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Griechisch</value>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Teñir el selector de canal con el color del canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>El botón selector de canal junto al campo de entrada se tiñe con el color del canal activo. Coincide con el tinte del texto de entrada.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Ocultar mientras el menú New Game+ esté abierto</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Oculta el chat mientras el menú New Game+ esté abierto. Al cerrar el menú, el chat se muestra de nuevo.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latín extendido</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Griego</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Teinter le sélecteur de canal avec la couleur du canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Le bouton sélecteur de canal à côté du champ de saisie est teinté avec la couleur du canal actif. Correspond à la teinte du texte de saisie.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Masquer pendant que le menu New Game+ est ouvert</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Masque le chat pendant que le menu New Game+ est ouvert. Fermer le menu réaffiche le chat.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latin étendu</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grec</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Colora il selettore di canale con il colore del canale</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Il pulsante selettore di canale accanto al campo di input viene colorato con il colore del canale attivo. Corrisponde alla colorazione del testo di input.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Nascondi mentre il menu New Game+ è aperto</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Nasconde la chat mentre il menu New Game+ è aperto. Chiudendo il menu, la chat riappare.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latino esteso</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Greco</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>チャンネルセレクターをチャンネル色で着色する</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>入力フィールドの隣のチャンネルセレクターボタンが、現在アクティブなチャンネルの色で着色されます。入力テキスト自体の色合いと一致します。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>ニューゲーム+メニューが開いている間は非表示</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>ニューゲーム+メニューが開いている間、チャットを非表示にします。メニューを閉じるとチャットが再表示されます。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>拡張ラテン</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>ギリシャ語</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>채널 선택기를 채널 색상으로 채색</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>입력 필드 옆의 채널 선택기 버튼이 현재 활성 채널 색상으로 채색됩니다. 입력 텍스트 자체의 색조와 일치합니다.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>뉴게임+ 메뉴가 열려 있는 동안 숨김</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>뉴게임+ 메뉴가 열려 있는 동안 채팅을 숨깁니다. 메뉴를 닫으면 채팅이 다시 표시됩니다.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>확장 라틴</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>그리스어</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Kanaalkiezer kleuren met kanaalkleur</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>De kanaalkiezerknop naast het invoerveld krijgt de kleur van het actieve kanaal. Komt overeen met de tint van de invoertekst zelf.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Verbergen terwijl het New Game+ menu open is</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Verberg de chat terwijl het New Game+ menu open is. Het sluiten van het menu toont de chat weer.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latijn uitgebreid</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grieks</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Colorir o seletor de canal com a cor do canal</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>O botão seletor de canal ao lado do campo de entrada é colorido com a cor do canal ativo. Combina com a coloração do próprio texto de entrada.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Ocultar enquanto o menu New Game+ estiver aberto</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Oculta o chat enquanto o menu New Game+ estiver aberto. Fechar o menu mostra o chat novamente.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latim estendido</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grego</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1478,4 +1478,10 @@ Your old database can still be recovered, please contact the plugin author for h
    <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latin Extended</value>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Greek</value>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Colorează selectorul de canal cu culoarea canalului</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Butonul selector de canal de lângă câmpul de intrare este colorat cu culoarea canalului activ. Se potrivește cu nuanța textului de intrare.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Ascunde cât timp meniul New Game+ este deschis</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Ascunde chatul cât timp meniul New Game+ este deschis. Închiderea meniului afișează chatul din nou.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Latină extinsă</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Greacă</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Окрашивать кнопку выбора канала в цвет канала</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Кнопка выбора канала рядом с полем ввода окрашивается в цвет активного канала. Совпадает с окраской самого текста ввода.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Скрывать, пока открыто меню New Game+</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Скрывать чат, пока открыто меню New Game+. При закрытии меню чат снова отображается.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Расширенная латиница</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Греческий</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>Färga kanalväljaren med kanalens färg</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>Kanalväljarknappen bredvid inmatningsfältet färgas med den aktiva kanalens färg. Matchar färgningen av själva inmatningstexten.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>Dölj medan New Game+ menyn är öppen</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>Dölj chatten medan New Game+ menyn är öppen. När menyn stängs visas chatten igen.</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>Utökat latin</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>Grekiska</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1466,4 +1466,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>用频道颜色为频道选择器染色</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>输入框旁边的频道选择器按钮将以当前活动频道的颜色着色。与输入文本本身的着色相匹配。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>在新游戏+菜单打开时隐藏</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>在新游戏+菜单打开时隐藏聊天。关闭菜单时聊天会再次显示。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>拉丁文扩展</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>希腊语</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -1467,4 +1467,28 @@ Your old database can still be recovered, please contact the plugin author for h
  <data name="ChatExport_Initial" xml:space="preserve">
        <value>Loading logs ...</value>
    </data>
+  <data name="Options_ColorSelectedInputChannelButton_Name" xml:space="preserve">
+    <value>用頻道顏色為頻道選擇器染色</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_ColorSelectedInputChannelButton_Description" xml:space="preserve">
+    <value>輸入框旁邊的頻道選擇器按鈕將以當前活動頻道的顏色著色。與輸入文字本身的著色相匹配。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Name" xml:space="preserve">
+    <value>在新遊戲+選單開啟時隱藏</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="Options_HideInNewGamePlusMenu_Description" xml:space="preserve">
+    <value>在新遊戲+選單開啟時隱藏聊天。關閉選單時聊天會再次顯示。</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_LatinExtended_Name" xml:space="preserve">
+    <value>拉丁文擴展</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
+  <data name="ExtraGlyphRanges_Greek_Name" xml:space="preserve">
+    <value>希臘文</value>
+    <comment>AI-assisted machine translation. Pending native-speaker review.</comment>
+  </data>
 </root>
@@ -0,0 +1,64 @@
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Resources;
+
+namespace HellionChat.SelfTests;
+
+// Verifies the v1.5.4 PM-2 quick-picker plumbing without rendering:
+// resource strings resolve, the theme registry yields the expected
+// minimum built-in count, and Config.Tabs is populated.
+internal sealed class QuickPickerSelfTestStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    public QuickPickerSelfTestStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - Quick picker plumbing";
+
+    public SelfTestStepResult RunStep()
+    {
+        if (string.IsNullOrWhiteSpace(HellionStrings.Settings_QuickPicker_Tooltip))
+        {
+            ImGui.Text("Settings_QuickPicker_Tooltip is empty in the active locale.");
+            return SelfTestStepResult.Fail;
+        }
+        if (string.IsNullOrWhiteSpace(HellionStrings.Settings_QuickPicker_Themes_Header))
+        {
+            ImGui.Text("Settings_QuickPicker_Themes_Header is empty in the active locale.");
+            return SelfTestStepResult.Fail;
+        }
+        if (string.IsNullOrWhiteSpace(HellionStrings.Settings_QuickPicker_Tabs_Header))
+        {
+            ImGui.Text("Settings_QuickPicker_Tabs_Header is empty in the active locale.");
+            return SelfTestStepResult.Fail;
+        }
+
+        var registry = this.plugin.ThemeRegistry;
+        if (registry is null)
+        {
+            ImGui.Text("ThemeRegistry not resolved.");
+            return SelfTestStepResult.Fail;
+        }
+
+        var builtIns = registry.AllBuiltIns().ToList();
+        if (builtIns.Count < 10)
+        {
+            ImGui.Text($"Expected at least 10 built-in themes, found {builtIns.Count}.");
+            return SelfTestStepResult.Fail;
+        }
+
+        var tabs = Plugin.Config.Tabs;
+        if (tabs is null || tabs.Count == 0)
+        {
+            ImGui.Text("Config.Tabs is empty.");
+            return SelfTestStepResult.Fail;
+        }
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp() { }
+}
@@ -0,0 +1,216 @@
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Themes;
+
+namespace HellionChat.SelfTests;
+
+// Verifies the v1.5.4 PM-1 crossfade contract: switching the active
+// theme arms TryGetActiveCrossfade for ~300ms, then the registry
+// returns to direct AbgrCache reads. A second switch within 100ms
+// keeps the lerped path active (no identity-snap). CleanUp restores
+// the initial theme so /xlperf stays idempotent.
+internal sealed class ThemeCrossfadeSelfTestStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    private string? initialSlug;
+    private string? targetSlug;
+    private string? midSwitchSlug;
+    private long armedAtTickMs = long.MinValue;
+    private long midArmedAtTickMs = long.MinValue;
+    private bool sawCrossfade;
+    private bool sawMidCrossfadeSwitch;
+    private bool sawCrossfadeEnd;
+    private bool restoredInitial;
+
+    public ThemeCrossfadeSelfTestStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - Theme crossfade";
+
+    public SelfTestStepResult RunStep()
+    {
+        var registry = this.plugin.ThemeRegistry;
+        if (registry is null)
+            return SelfTestStepResult.Fail;
+
+        if (this.initialSlug is null)
+        {
+            this.initialSlug = registry.Active.Slug;
+            this.targetSlug = PickDifferentSlug(registry, this.initialSlug);
+            if (this.targetSlug is null)
+            {
+                ImGui.Text("Need at least two themes available; only one built-in found.");
+                return SelfTestStepResult.Fail;
+            }
+
+            registry.Switch(this.targetSlug);
+            this.armedAtTickMs = Environment.TickCount64;
+            ImGui.Text($"Crossfade armed: {this.initialSlug} -> {this.targetSlug}");
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.sawCrossfade)
+        {
+            if (registry.TryGetActiveCrossfade(out _))
+            {
+                this.sawCrossfade = true;
+                this.midArmedAtTickMs = Environment.TickCount64;
+                ImGui.Text("Crossfade observed mid-window, arming mid-switch test...");
+                return SelfTestStepResult.Waiting;
+            }
+
+            // If the window already closed before we observed it, that
+            // is acceptable only on extremely slow frame paths; accept
+            // it as "saw the start" if more than 300ms have elapsed.
+            // Skip the mid-crossfade-switch phase in that case -- the
+            // lerped path is no longer active, so a second switch would
+            // re-arm a fresh crossfade and not exercise PM-1b's
+            // mid-flight-origin override.
+            if (Environment.TickCount64 - this.armedAtTickMs > 300)
+            {
+                this.sawCrossfade = true;
+                this.sawMidCrossfadeSwitch = true;
+                this.sawCrossfadeEnd = true;
+                ImGui.Text("Crossfade window closed before observation; accepting.");
+                return SelfTestStepResult.Waiting;
+            }
+
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.sawMidCrossfadeSwitch)
+        {
+            // PM-Test-3 mid-crossfade-switch phase: within ~100ms of the
+            // first observed crossfade, fire a second Switch to a THIRD
+            // theme. ArmCrossfade must compose the current lerped state
+            // as the new origin -- TryGetActiveCrossfade still returns
+            // true (lerped path stays active, no identity-snap) and the
+            // lerped value is neither the identity-from nor the
+            // identity-to of the new switch (origin shifted to the
+            // mid-flight cache, target is the third theme).
+            if (Environment.TickCount64 - this.midArmedAtTickMs < 100)
+            {
+                this.midSwitchSlug = PickDifferentSlug(
+                    registry,
+                    [this.initialSlug!, this.targetSlug!]
+                );
+                if (this.midSwitchSlug is null)
+                {
+                    // Only two themes available -- mid-switch phase cannot
+                    // exercise the lerped-origin path. Accept and move on
+                    // (the v1.5.3 baseline ships >=10 built-ins, so this
+                    // branch is defensive).
+                    this.sawMidCrossfadeSwitch = true;
+                    ImGui.Text("Only two themes available; skipping mid-switch assert.");
+                    return SelfTestStepResult.Waiting;
+                }
+
+                var fromCache = registry.Active.AbgrCache;
+                registry.Switch(this.midSwitchSlug);
+                var toCache = registry.Active.AbgrCache;
+
+                if (!registry.TryGetActiveCrossfade(out var midLerped))
+                {
+                    ImGui.Text("Mid-switch failed: TryGetActiveCrossfade returned false.");
+                    return SelfTestStepResult.Fail;
+                }
+
+                // Lerped value must be neither the new identity-from
+                // (target cache of the first switch) nor the new
+                // identity-to (third theme cache) -- it must originate
+                // from the mid-flight composed snapshot.
+                if (midLerped.Equals(fromCache) || midLerped.Equals(toCache))
+                {
+                    ImGui.Text("Mid-switch failed: lerped value is an identity snap.");
+                    return SelfTestStepResult.Fail;
+                }
+
+                this.sawMidCrossfadeSwitch = true;
+                ImGui.Text(
+                    $"Mid-switch armed: {this.targetSlug} -> {this.midSwitchSlug} (lerped origin)."
+                );
+                return SelfTestStepResult.Waiting;
+            }
+
+            // Window for mid-switch already elapsed; accept and continue.
+            this.sawMidCrossfadeSwitch = true;
+            ImGui.Text("Mid-switch window elapsed before fire; accepting.");
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.sawCrossfadeEnd)
+        {
+            if (!registry.TryGetActiveCrossfade(out _))
+            {
+                this.sawCrossfadeEnd = true;
+                ImGui.Text("Crossfade window closed cleanly.");
+                return SelfTestStepResult.Waiting;
+            }
+            return SelfTestStepResult.Waiting;
+        }
+
+        if (!this.restoredInitial)
+        {
+            registry.Switch(this.initialSlug);
+            this.restoredInitial = true;
+            ImGui.Text($"Restored: {this.initialSlug}");
+            return SelfTestStepResult.Waiting;
+        }
+
+        // Wait for the restore-crossfade to also conclude before
+        // declaring Pass, so /xlperf does not flicker out mid-fade.
+        if (registry.TryGetActiveCrossfade(out _))
+            return SelfTestStepResult.Waiting;
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp()
+    {
+        // Best-effort: if anything went sideways, snap back to the
+        // initial slug. Switch is idempotent on same-slug.
+        var registry = this.plugin.ThemeRegistry;
+        if (registry is not null && this.initialSlug is not null)
+        {
+            registry.Switch(this.initialSlug);
+        }
+
+        this.initialSlug = null;
+        this.targetSlug = null;
+        this.midSwitchSlug = null;
+        this.armedAtTickMs = long.MinValue;
+        this.midArmedAtTickMs = long.MinValue;
+        this.sawCrossfade = false;
+        this.sawMidCrossfadeSwitch = false;
+        this.sawCrossfadeEnd = false;
+        this.restoredInitial = false;
+    }
+
+    private static string? PickDifferentSlug(ThemeRegistry registry, string activeSlug) =>
+        PickDifferentSlug(registry, [activeSlug]);
+
+    private static string? PickDifferentSlug(
+        ThemeRegistry registry,
+        IReadOnlyCollection<string> excludeSlugs
+    )
+    {
+        foreach (var theme in registry.AllBuiltIns())
+        {
+            var match = false;
+            foreach (var excluded in excludeSlugs)
+            {
+                if (string.Equals(theme.Slug, excluded, StringComparison.OrdinalIgnoreCase))
+                {
+                    match = true;
+                    break;
+                }
+            }
+            if (!match)
+                return theme.Slug;
+        }
+        return null;
+    }
+}
@@ -0,0 +1,135 @@
+using System.Collections.Generic;
+using Dalamud.Bindings.ImGui;
+using Dalamud.Plugin.SelfTest;
+using HellionChat.Code;
+using HellionChat.Ui;
+
+namespace HellionChat.SelfTests;
+
+// Drives the FirstRunWizard state machine through every step and
+// commits a no-op pending state (Variant 1), then re-runs picking
+// Roleplay on Step 2 and skipping Step 3 (Variant 2). Verifies
+// that the staged-commit path does not throw under any combination
+// of Pending* values and that CommitPending leaves Config in a
+// readable shape. Variant 2's Roleplay commit would normally
+// mutate the six PrivacyFilter / Retention fields ApplyRoleplay
+// touches, so the step snapshots them before Variant 2 runs and
+// CleanUp() restores them — the self-test stays idempotent across
+// repeated /xlperf runs and does not overwrite an active privacy
+// profile.
+internal sealed class WizardStateSmokeStep : ISelfTestStep
+{
+    private readonly Plugin plugin;
+
+    // Snapshot slots for the six Configuration fields ApplyRoleplay
+    // writes in Variant 2. Populated right before Variant 2 mutates
+    // Config, consumed by CleanUp(). Reference-typed snapshots
+    // (HashSet, Dictionary) capture the existing slot by reference,
+    // which is safe because ApplyRoleplay reassigns the slot with
+    // a fresh instance instead of mutating in place.
+    private bool? snapshotPrivacyFilterEnabled;
+    private HashSet<ChatType>? snapshotPrivacyPersistChannels;
+    private bool? snapshotPrivacyPersistUnknownChannels;
+    private bool? snapshotRetentionEnabled;
+    private int? snapshotRetentionDefaultDays;
+    private Dictionary<ChatType, int>? snapshotRetentionPerChannelDays;
+
+    public WizardStateSmokeStep(Plugin plugin)
+    {
+        this.plugin = plugin;
+    }
+
+    public string Name => "Hellion Chat - FirstRunWizard state smoke";
+
+    public SelfTestStepResult RunStep()
+    {
+        var wizard = this.plugin.FirstRunWizard;
+        if (wizard is null)
+        {
+            ImGui.Text("Plugin.FirstRunWizard is null");
+            return SelfTestStepResult.Fail;
+        }
+
+        try
+        {
+            // Variant 1: no-op CommitPending. Walks the state machine and
+            // verifies the empty-pending write-back path does not throw.
+            wizard.TestOnly_AdvanceTo(1);
+            wizard.TestOnly_AdvanceTo(2);
+            wizard.TestOnly_AdvanceTo(3);
+            wizard.TestOnly_AdvanceTo(4);
+            wizard.CommitPending();
+
+            // Variant 2: skip Step 3 explicitly. Picks Roleplay on Step 2,
+            // jumps straight to Step 4 (no Step-3 entry → no seed for
+            // LoadPreviousSession / FilterIncludePreviousSessions), commits,
+            // and asserts the two coupled history toggles remained on their
+            // pre-test value. Pins the null-semantics from Spec Z.176 so a
+            // regression in CommitPending that started writing seeded
+            // recommendations unconditionally would surface here.
+            // CommitPending → ApplyRoleplay overwrites six privacy /
+            // retention fields, so snapshot them first and let CleanUp
+            // restore them after the assert. Keeps /xlperf idempotent.
+            this.snapshotPrivacyFilterEnabled = Plugin.Config.PrivacyFilterEnabled;
+            this.snapshotPrivacyPersistChannels = Plugin.Config.PrivacyPersistChannels;
+            this.snapshotPrivacyPersistUnknownChannels = Plugin
+                .Config
+                .PrivacyPersistUnknownChannels;
+            this.snapshotRetentionEnabled = Plugin.Config.RetentionEnabled;
+            this.snapshotRetentionDefaultDays = Plugin.Config.RetentionDefaultDays;
+            this.snapshotRetentionPerChannelDays = Plugin.Config.RetentionPerChannelDays;
+
+            var loadPrevBefore = Plugin.Config.LoadPreviousSession;
+            var filterPrevBefore = Plugin.Config.FilterIncludePreviousSessions;
+            wizard.TestOnly_AdvanceTo(2);
+            wizard.TestOnly_SetPendingProfile(FirstRunWizard.PrivacyProfile.Roleplay);
+            wizard.TestOnly_AdvanceTo(4);
+            wizard.CommitPending();
+            if (Plugin.Config.LoadPreviousSession != loadPrevBefore)
+            {
+                ImGui.Text("Skip-Step-3 path overwrote LoadPreviousSession");
+                return SelfTestStepResult.Fail;
+            }
+            if (Plugin.Config.FilterIncludePreviousSessions != filterPrevBefore)
+            {
+                ImGui.Text("Skip-Step-3 path overwrote FilterIncludePreviousSessions");
+                return SelfTestStepResult.Fail;
+            }
+        }
+        catch (Exception ex)
+        {
+            ImGui.Text($"Wizard state smoke threw: {ex.GetType().Name}: {ex.Message}");
+            return SelfTestStepResult.Fail;
+        }
+
+        return SelfTestStepResult.Pass;
+    }
+
+    public void CleanUp()
+    {
+        // Restore the six Variant-2 snapshots so back-to-back /xlperf
+        // runs don't drift the active privacy profile. If Variant 2
+        // never ran (Variant 1 threw early), the slots stay null and
+        // restore is a no-op. After restore the slots are nulled so a
+        // future RunStep starts fresh.
+        if (this.snapshotPrivacyFilterEnabled is { } privacyFilter)
+            Plugin.Config.PrivacyFilterEnabled = privacyFilter;
+        if (this.snapshotPrivacyPersistChannels is { } persistChannels)
+            Plugin.Config.PrivacyPersistChannels = persistChannels;
+        if (this.snapshotPrivacyPersistUnknownChannels is { } persistUnknown)
+            Plugin.Config.PrivacyPersistUnknownChannels = persistUnknown;
+        if (this.snapshotRetentionEnabled is { } retentionEnabled)
+            Plugin.Config.RetentionEnabled = retentionEnabled;
+        if (this.snapshotRetentionDefaultDays is { } retentionDays)
+            Plugin.Config.RetentionDefaultDays = retentionDays;
+        if (this.snapshotRetentionPerChannelDays is { } retentionPolicy)
+            Plugin.Config.RetentionPerChannelDays = retentionPolicy;
+
+        this.snapshotPrivacyFilterEnabled = null;
+        this.snapshotPrivacyPersistChannels = null;
+        this.snapshotPrivacyPersistUnknownChannels = null;
+        this.snapshotRetentionEnabled = null;
+        this.snapshotRetentionDefaultDays = null;
+        this.snapshotRetentionPerChannelDays = null;
+    }
+}
@@ -0,0 +1,61 @@
+namespace HellionChat.Themes;
+
+// Per-slot ABGR byte-lerp between two ThemeAbgrCache value-records.
+// Pattern anchor: imgui.cpp:2820-2828 ImAlphaBlendColors -- decompose
+// each byte, lerp via Math.Round, recompose. Stack-allocated output
+// (readonly record struct), no heap pressure inside the crossfade
+// window. t is clamped to [0, 1] so float drift cannot overshoot.
+internal static class ThemeAbgrCacheLerp
+{
+    public static ThemeAbgrCache Lerp(ThemeAbgrCache from, ThemeAbgrCache to, float t)
+    {
+        t = Math.Clamp(t, 0f, 1f);
+
+        return new ThemeAbgrCache(
+            PrimaryDark: LerpAbgr(from.PrimaryDark, to.PrimaryDark, t),
+            Primary: LerpAbgr(from.Primary, to.Primary, t),
+            PrimaryLight: LerpAbgr(from.PrimaryLight, to.PrimaryLight, t),
+            PrimaryGlow: LerpAbgr(from.PrimaryGlow, to.PrimaryGlow, t),
+            AccentDark: LerpAbgr(from.AccentDark, to.AccentDark, t),
+            Accent: LerpAbgr(from.Accent, to.Accent, t),
+            AccentLight: LerpAbgr(from.AccentLight, to.AccentLight, t),
+            Identity: LerpAbgr(from.Identity, to.Identity, t),
+            WindowBg: LerpAbgr(from.WindowBg, to.WindowBg, t),
+            ChildBg: LerpAbgr(from.ChildBg, to.ChildBg, t),
+            FrameBg: LerpAbgr(from.FrameBg, to.FrameBg, t),
+            Surface: LerpAbgr(from.Surface, to.Surface, t),
+            SurfaceHover: LerpAbgr(from.SurfaceHover, to.SurfaceHover, t),
+            Border: LerpAbgr(from.Border, to.Border, t),
+            TextPrimary: LerpAbgr(from.TextPrimary, to.TextPrimary, t),
+            TextMuted: LerpAbgr(from.TextMuted, to.TextMuted, t),
+            TextDim: LerpAbgr(from.TextDim, to.TextDim, t),
+            StatusSuccess: LerpAbgr(from.StatusSuccess, to.StatusSuccess, t),
+            StatusDanger: LerpAbgr(from.StatusDanger, to.StatusDanger, t),
+            StatusWarning: LerpAbgr(from.StatusWarning, to.StatusWarning, t),
+            StatusInfo: LerpAbgr(from.StatusInfo, to.StatusInfo, t)
+        );
+    }
+
+    private static uint LerpAbgr(uint from, uint to, float t)
+    {
+        var ra = (byte)(from & 0xFFu);
+        var ga = (byte)((from >> 8) & 0xFFu);
+        var ba = (byte)((from >> 16) & 0xFFu);
+        var aa = (byte)((from >> 24) & 0xFFu);
+
+        var rb = (byte)(to & 0xFFu);
+        var gb = (byte)((to >> 8) & 0xFFu);
+        var bb = (byte)((to >> 16) & 0xFFu);
+        var ab = (byte)((to >> 24) & 0xFFu);
+
+        // Math.Round (default ToEven) matches ColourUtil.ApplyAlpha so a
+        // crossfade-into-hover transition does not produce a one-byte
+        // jump at the midpoint between the two paths.
+        var r = (byte)Math.Round(ra + (rb - ra) * t);
+        var g = (byte)Math.Round(ga + (gb - ga) * t);
+        var b = (byte)Math.Round(ba + (bb - ba) * t);
+        var a = (byte)Math.Round(aa + (ab - aa) * t);
+
+        return ((uint)a << 24) | ((uint)b << 16) | ((uint)g << 8) | r;
+    }
+}
@@ -32,6 +32,16 @@ public sealed class ThemeRegistry
    private long _lastActiveStampCheckMs = -ActiveStampPollIntervalMs;
    private DateTime _lastActiveStamp = DateTime.MinValue;

+    // PM-1 crossfade state. Switch() captures the previous AbgrCache as a
+    // VALUE-COPY (not a Theme reference) -- the built-in singletons share
+    // their RecomputeAbgrCache identity, so a reference would mutate
+    // alongside the new active. _crossfadeStartTickMs == long.MinValue
+    // means "no crossfade armed yet"; the field stays MinValue after
+    // SwitchSilent so the plugin-load init-path does not trigger a fade.
+    private ThemeAbgrCache? _previousAbgrSnapshot;
+    private long _crossfadeStartTickMs = long.MinValue;
+    private const int CrossfadeDurationMs = 300;
+
    public ThemeRegistry(string? customThemesDir = null, ILogger<ThemeRegistry>? logger = null)
    {
        _logger = logger;
@@ -87,6 +97,13 @@ public sealed class ThemeRegistry
    // a state where _active and Get(_active.Slug) disagree.
    public void Switch(string slug)
    {
+        // Same-slug switch is a no-op -- avoids a 300ms identity-crossfade
+        // when the user re-selects the active theme in the picker.
+        if (string.Equals(_active.Slug, slug, StringComparison.OrdinalIgnoreCase))
+            return;
+
+        ArmCrossfade();
+
        if (_builtIns.TryGetValue(slug, out var builtin))
        {
            _active = builtin;
@@ -115,6 +132,84 @@ public sealed class ThemeRegistry
        _activeCustomPath = null;
    }

+    // SwitchSilent is the plugin-load init path -- identical to Switch
+    // but does NOT arm the crossfade state. Called from
+    // ThemeRegistryInitHostedService.StartAsync so opening the plugin
+    // does not produce a 300ms fade from the default theme to the user's
+    // saved theme.
+    public void SwitchSilent(string slug)
+    {
+        if (string.Equals(_active.Slug, slug, StringComparison.OrdinalIgnoreCase))
+            return;
+
+        if (_builtIns.TryGetValue(slug, out var builtin))
+        {
+            _active = builtin;
+            _active.RecomputeAbgrCache();
+            _activeCustomPath = null;
+            return;
+        }
+
+        var customTheme = LoadCustomBySlug(slug, out var customPath);
+        if (customTheme is not null)
+        {
+            _active = customTheme;
+            _active.RecomputeAbgrCache();
+            _activeCustomPath = customPath;
+            _lastActiveStamp = DateTime.MinValue;
+            return;
+        }
+
+        _active = _builtIns[DefaultSlug];
+        _active.RecomputeAbgrCache();
+        _activeCustomPath = null;
+    }
+
+    // Captures the AbgrCache snapshot that PushGlobal should fade FROM.
+    // If a crossfade is already mid-flight (second Switch within 300ms),
+    // the current lerped state replaces the snapshot -- the next fade
+    // starts from where we currently are, not from the original "from".
+    private void ArmCrossfade()
+    {
+        var now = Environment.TickCount64;
+        ThemeAbgrCache snapshot;
+        if (
+            _previousAbgrSnapshot.HasValue
+            && _crossfadeStartTickMs != long.MinValue
+            && now - _crossfadeStartTickMs < CrossfadeDurationMs
+        )
+        {
+            var t = (float)(now - _crossfadeStartTickMs) / CrossfadeDurationMs;
+            snapshot = ThemeAbgrCacheLerp.Lerp(_previousAbgrSnapshot.Value, _active.AbgrCache, t);
+        }
+        else
+        {
+            snapshot = _active.AbgrCache;
+        }
+
+        _previousAbgrSnapshot = snapshot;
+        _crossfadeStartTickMs = now;
+    }
+
+    // Returns the lerped AbgrCache while the crossfade is active.
+    // PushGlobal reads this once per frame; outside the 300ms window
+    // it short-circuits via the TickCount64 delta so the per-frame
+    // overhead is a couple of integer comparisons.
+    public bool TryGetActiveCrossfade(out ThemeAbgrCache lerped)
+    {
+        lerped = default;
+        if (_crossfadeStartTickMs == long.MinValue || !_previousAbgrSnapshot.HasValue)
+            return false;
+
+        var elapsed = Environment.TickCount64 - _crossfadeStartTickMs;
+        if (elapsed >= CrossfadeDurationMs)
+            return false;
+
+        var t = (float)elapsed / CrossfadeDurationMs;
+        lerped = ThemeAbgrCacheLerp.Lerp(_previousAbgrSnapshot.Value, _active.AbgrCache, t);
+        return true;
+    }
+
    // 1Hz-throttled disk-stat on the currently active custom theme file.
    // When the file's LastWriteTime moves forward (editor save), reload the
    // theme via Get() so the user sees the edit immediately without
@@ -472,6 +472,105 @@ public sealed class ChatLogWindow : Window
        ChangeTab(newIndex);
    }

+    // PM-2b v1.5.4 header quick-picker. Two scrollable sections -- every
+    // built-in plus custom theme, and every tab. Clicking a theme arms
+    // the PM-1 crossfade via ThemeRegistry.Switch; clicking a tab routes
+    // through ChangeTab so LastActivityTime stays consistent with the
+    // sidebar and top-bar click paths. DontClosePopups keeps the popup
+    // open so the user can hop between entries without re-opening it.
+    private void DrawQuickPickerPopup()
+    {
+        using var popup = ImRaii.Popup("##hellion-quick-picker");
+        if (!popup.Success)
+            return;
+
+        ImGui.TextUnformatted(HellionStrings.Settings_QuickPicker_Themes_Header);
+        ImGui.Separator();
+
+        var activeSlug = Plugin.ThemeRegistry.Active.Slug;
+        var allThemes = Plugin
+            .ThemeRegistry.AllBuiltIns()
+            .Concat(Plugin.ThemeRegistry.AllCustom())
+            .ToList();
+
+        using (
+            var scroll = ImRaii.Child(
+                "##hellion-quick-picker-themes",
+                new Vector2(220f, Math.Min(allThemes.Count * 22f, 200f))
+            )
+        )
+        {
+            if (scroll.Success)
+            {
+                foreach (var theme in allThemes)
+                {
+                    var isActive = string.Equals(
+                        theme.Slug,
+                        activeSlug,
+                        StringComparison.OrdinalIgnoreCase
+                    );
+                    DrawQuickPickerGlyph(isActive);
+                    if (
+                        ImGui.Selectable(
+                            $"{theme.Name}##quick-theme-{theme.Slug}",
+                            isActive,
+                            ImGuiSelectableFlags.DontClosePopups
+                        ) && !isActive
+                    )
+                        Plugin.ThemeRegistry.Switch(theme.Slug);
+                }
+            }
+        }
+
+        ImGui.Spacing();
+        ImGui.TextUnformatted(HellionStrings.Settings_QuickPicker_Tabs_Header);
+        ImGui.Separator();
+
+        var tabs = Plugin.Config.Tabs;
+        var activeTabIndex = Plugin.LastTab;
+        using (
+            var scroll = ImRaii.Child(
+                "##hellion-quick-picker-tabs",
+                new Vector2(220f, Math.Min(tabs.Count * 22f, 200f))
+            )
+        )
+        {
+            if (scroll.Success)
+            {
+                for (var i = 0; i < tabs.Count; i++)
+                {
+                    var isActive = i == activeTabIndex;
+                    DrawQuickPickerGlyph(isActive);
+                    if (
+                        ImGui.Selectable(
+                            $"{tabs[i].Name}##quick-tab-{i}",
+                            isActive,
+                            ImGuiSelectableFlags.DontClosePopups
+                        ) && !isActive
+                    )
+                        ChangeTab(i);
+                }
+            }
+        }
+    }
+
+    // Leading check-glyph slot for a quick-picker row. Active rows get a
+    // FontAwesome check; inactive rows get a same-width blank so the
+    // labels stay aligned. The glyph font push stays on its own line so
+    // it never bleeds into the body-font Selectable label.
+    private void DrawQuickPickerGlyph(bool isActive)
+    {
+        using (Plugin.FontManager.FontAwesome.Push())
+        {
+            var check = FontAwesomeIcon.Check.ToIconString();
+            if (isActive)
+                ImGui.TextUnformatted(check);
+            else
+                ImGui.Dummy(new Vector2(ImGui.CalcTextSize(check).X, ImGui.GetTextLineHeight()));
+        }
+        ImGui.SameLine();
+    }
+
    private void TabSwitched(Tab newTab, Tab previousTab)
    {
        // Use the fixed channel if set by the user. Otherwise, if the new tab
@@ -903,7 +1002,15 @@ public sealed class ChatLogWindow : Window
        var buttonWidth = afterIcon.X - beforeIcon.X;
        var showNovice = Plugin.Config.ShowNoviceNetwork && GameFunctions.GameFunctions.IsMentor();
        var buttonsRight = (showNovice ? 1 : 0) + (Plugin.Config.ShowHideButton ? 1 : 0);
-        var inputWidth = ImGui.GetContentRegionAvail().X - buttonWidth * (1 + buttonsRight);
+        // Right-side buttons: quick-picker palette + cog (always present)
+        // plus the optional hide / novice buttons. Each slot costs the
+        // measured button width AND one ItemSpacing for the SameLine gap
+        // in front of it -- leaving the spacing term out overflows the
+        // header row by one gap per button (v1.5.4 quick-picker fix).
+        var rightButtonCount = 2 + buttonsRight;
+        var inputWidth =
+            ImGui.GetContentRegionAvail().X
+            - rightButtonCount * (buttonWidth + ImGui.GetStyle().ItemSpacing.X);

        var normalColor = ImGui.GetColorU32(ImGuiCol.Text);
        var push = inputColour != null;
@@ -1013,6 +1120,19 @@ public sealed class ChatLogWindow : Window

        ImGui.SameLine();

+        if (
+            ImGuiUtil.IconButton(
+                FontAwesomeIcon.Palette,
+                tooltip: HellionStrings.Settings_QuickPicker_Tooltip,
+                width: (int)buttonWidth
+            )
+        )
+            ImGui.OpenPopup("##hellion-quick-picker");
+
+        DrawQuickPickerPopup();
+
+        ImGui.SameLine();
+
        if (ImGuiUtil.IconButton(FontAwesomeIcon.Cog, width: (int)buttonWidth))
            Plugin.SettingsWindow.Toggle();

@@ -1505,15 +1625,19 @@ public sealed class ChatLogWindow : Window
            var maxLines = Plugin.Config.MaxLinesToRender;
            var startLine = messages.Count > maxLines ? messages.Count - maxLines : 0;

-            // Card-mode pre-loop: theme/drawList/winLeft/winRight/border are invariant
-            // per DrawMessages call; only cursorY moves per row.
+            // Card-mode pre-loop: theme/drawList/winLeft/winRight are
+            // invariant per DrawMessages call. borderColorAbgr used to be
+            // hoisted here too, but PM-3d (v1.5.4) modulates it by
+            // tab._cardHoverAlpha per row, so it moves into the AddLine
+            // call below. anyCardHovered aggregates the row-hover state
+            // across all card-rows; the lerp runs once at the loop end so
+            // the next frame paints with the updated alpha.
            var theme = Plugin.ThemeRegistry.Active;
            var drawList = ImGui.GetWindowDrawList();
            var winLeft = ImGui.GetWindowPos().X;
            var winRight = winLeft + ImGui.GetWindowSize().X;
-            var borderColorAbgr = ColourUtil.RgbaToAbgr(
-                (theme.Colors.Border & 0xFFFFFF00u) | 0x33u
-            );
+            var baseBorderRgba = (theme.Colors.Border & 0xFFFFFF00u) | 0x33u;
+            var anyCardHovered = false;

            for (var i = startLine; i < messages.Count; i++)
            {
@@ -1669,6 +1793,8 @@ public sealed class ChatLogWindow : Window
                var useCard = !Plugin.Config.UseCompactDensity;
                if (useCard)
                {
+                    var rowStartY = ImGui.GetCursorScreenPos().Y;
+
                    if (message.Sender.Count > 0)
                    {
                        var senderColor =
@@ -1692,9 +1818,18 @@ public sealed class ChatLogWindow : Window
                    else
                        DrawChunks(message.Content, true, handler, lineWidth);

-                    // Border bottom as card separator. Alpha reduced to 0x33 for subtlety.
+                    // Border bottom as card separator. Base alpha 0x33;
+                    // PM-3d lifts it by up to ~+0x70 while any row in this
+                    // tab is hovered. _cardHoverAlpha lerps at the loop
+                    // end, so the one-frame lag is invisible at 10f speed.
                    {
                        var rowEndY = ImGui.GetCursorScreenPos().Y;
+                        var hoverBoost = 0.45f * tab._cardHoverAlpha;
+                        var alphaByte = (uint)
+                            Math.Clamp((int)(0x33u + hoverBoost * 255f), 0x33, 0xCC);
+                        var borderColorAbgr = ColourUtil.RgbaToAbgr(
+                            (baseBorderRgba & 0xFFFFFF00u) | alphaByte
+                        );
                        drawList.AddLine(
                            new Vector2(winLeft + 4, rowEndY - 1),
                            new Vector2(winRight - 4, rowEndY - 1),
@@ -1702,6 +1837,17 @@ public sealed class ChatLogWindow : Window
                            1f
                        );
                        ImGui.Dummy(new Vector2(0, 2));
+
+                        // Whole-row hover test. IsItemHovered would only see
+                        // the 2px Dummy above, so hit-test the row rect from
+                        // its start Y down to the separator line instead.
+                        if (
+                            ImGui.IsMouseHoveringRect(
+                                new Vector2(winLeft, rowStartY),
+                                new Vector2(winRight, rowEndY)
+                            )
+                        )
+                            anyCardHovered = true;
                    }
                }
                else
@@ -1726,6 +1872,20 @@ public sealed class ChatLogWindow : Window

                message.IsVisible[tab.Identifier] = ImGui.IsItemVisible();
            }
+
+            // PM-3d: update the per-tab card-hover lerp once per
+            // DrawMessages call. ReduceMotion snaps to the target;
+            // otherwise the border alpha eases toward it over a few
+            // frames the next time the rows paint.
+            var cardTarget = anyCardHovered ? 1f : 0f;
+            tab._cardHoverAlpha = Plugin.Config.ReduceMotion
+                ? cardTarget
+                : FrameLerp.Smooth(
+                    tab._cardHoverAlpha,
+                    cardTarget,
+                    speed: 10f,
+                    deltaTime: ImGui.GetIO().DeltaTime
+                );
        }
        catch (ApplicationException)
        {
@@ -1976,7 +2136,19 @@ public sealed class ChatLogWindow : Window
                            ColourUtil.RgbaToAbgr(theme.Colors.Surface)
                        )
                    )
-                    using (ImRaii.PushColor(ImGuiCol.Text, ColourUtil.RgbaToAbgr(iconColor)))
+                    // PM-3c: icon alpha eases from 40% (dim) to 100% on
+                    // hover. _hoverAlpha lerps at the end of this block,
+                    // so the colour for frame N uses frame N-1's value --
+                    // a sub-frame lag that is invisible at 10f speed.
+                    using (
+                        ImRaii.PushColor(
+                            ImGuiCol.Text,
+                            ColourUtil.ApplyAlpha(
+                                ColourUtil.RgbaToAbgr(iconColor),
+                                0.4f + 0.6f * tab._hoverAlpha
+                            )
+                        )
+                    )
                    using (Plugin.FontManager.FontAwesome.Push())
                    {
                        // Button stretches with the configured sidebar width so a
@@ -1988,6 +2160,19 @@ public sealed class ChatLogWindow : Window
                        );
                    }

+                    // PM-3c hover-lerp: ramp _hoverAlpha toward 1 while the
+                    // icon button is hovered, back to 0 otherwise.
+                    // ReduceMotion snaps so the dim/full states stay binary.
+                    var hoverTarget = ImGui.IsItemHovered() ? 1f : 0f;
+                    tab._hoverAlpha = Plugin.Config.ReduceMotion
+                        ? hoverTarget
+                        : FrameLerp.Smooth(
+                            tab._hoverAlpha,
+                            hoverTarget,
+                            speed: 10f,
+                            deltaTime: ImGui.GetIO().DeltaTime
+                        );
+
                    if (isCurrentTab)
                    {
                        // Vertical accent pill on the left window edge, 3px wide, half tab height,
@@ -1,3 +1,4 @@
+using System.Globalization;
 using System.Numerics;
 using Dalamud.Bindings.ImGui;
 using Dalamud.Interface.Utility.Raii;
@@ -6,13 +7,34 @@ using HellionChat.Branding;
 using HellionChat.Code;
 using HellionChat.Privacy;
 using HellionChat.Resources;
+using HellionChat.Themes;
 using HellionChat.Util;

 namespace HellionChat.Ui;

+// Multi-step first-run wizard. public sealed because Plugin.cs has a
+// public-typed property on this class — narrowing to internal would
+// be a build break across the assembly boundary. State lives in a
+// nested WizardState record; every step writes nullable Pending*
+// fields, and CommitPending() applies only the non-null ones so
+// users who skip a step never get their existing config overwritten.
 public sealed class FirstRunWizard : Window
 {
+    // Forge-Bronze (#C2410C). The same constant lives in ThemeRegistry
+    // and the forge-announce workflow; pinning it locally keeps the
+    // wizard render path free of registry lookups during draw.
+    private static readonly Vector4 ForgeBronze = new(0xC2 / 255f, 0x41 / 255f, 0x0C / 255f, 1f);
+    private static readonly Vector4 ForgeBronzeDim = new(
+        0xC2 / 255f,
+        0x41 / 255f,
+        0x0C / 255f,
+        0.3f
+    );
+
+    private const int TotalSteps = 4;
+
    private readonly Plugin Plugin;
+    private readonly WizardState _state = new();

    internal FirstRunWizard(Plugin plugin)
        : base($"{HellionStrings.Wizard_Title}###hellion-firstrun")
@@ -21,10 +43,10 @@ public sealed class FirstRunWizard : Window

        Flags = ImGuiWindowFlags.NoCollapse | ImGuiWindowFlags.NoDocking;
        SizeCondition = ImGuiCond.Appearing;
-        Size = new Vector2(900, 560);
+        Size = new Vector2(720, 480);
        SizeConstraints = new WindowSizeConstraints
        {
-            MinimumSize = new Vector2(720, 480),
+            MinimumSize = new Vector2(600, 400),
            MaximumSize = new Vector2(float.MaxValue, float.MaxValue),
        };
    }
@@ -32,138 +54,536 @@ public sealed class FirstRunWizard : Window
    public override void OnClose()
    {
        // OnClose fires on explicit X-click and on plugin dispose. We never
-        // implicitly accept the defaults here — the explicit "Later" button
-        // does that. If the user hasn't picked a profile yet, the wizard
-        // reopens on the next plugin load.
+        // implicitly accept the defaults here — both the explicit "Decide
+        // later" footer link and a successful "Finish ✓" set FirstRunCompleted
+        // = true, so the wizard does not reopen on the next plugin load
+        // regardless of which path the user took.
    }

    public override void Draw()
    {
-        DrawHellionForgeAnchor();
+        DrawPagination();
        ImGui.Spacing();
        ImGui.Separator();
        ImGui.Spacing();

-        ImGui.TextWrapped(HellionStrings.Wizard_Intro);
-        ImGui.Spacing();
-        ImGui.Separator();
-        ImGui.Spacing();
-
-        var avail = ImGui.GetContentRegionAvail();
-        var cardWidth = (avail.X - ImGui.GetStyle().ItemSpacing.X * 2) / 3f;
-        // Reserve room for the footer separator + cancel button below the cards.
-        var footerReserve =
-            ImGui.GetStyle().ItemSpacing.Y * 3
-            + ImGui.GetTextLineHeight()
-            + ImGui.GetFrameHeightWithSpacing();
-        var cardHeight = avail.Y - footerReserve;
-
-        DrawCard(
-            "privacy-first",
-            cardWidth,
-            cardHeight,
-            HellionStrings.Wizard_Profile_PrivacyFirst_Heading,
-            HellionStrings.Wizard_Profile_PrivacyFirst_Description,
-            null,
-            HellionStrings.Wizard_Profile_PrivacyFirst_Apply,
-            ApplyPrivacyFirst
-        );
-
-        ImGui.SameLine();
-
-        DrawCard(
-            "casual",
-            cardWidth,
-            cardHeight,
-            HellionStrings.Wizard_Profile_Casual_Heading,
-            HellionStrings.Wizard_Profile_Casual_Description,
-            null,
-            HellionStrings.Wizard_Profile_Casual_Apply,
-            ApplyCasual
-        );
-
-        ImGui.SameLine();
-
-        DrawCard(
-            "full-history",
-            cardWidth,
-            cardHeight,
-            HellionStrings.Wizard_Profile_FullHistory_Heading,
-            HellionStrings.Wizard_Profile_FullHistory_Description,
-            HellionStrings.Wizard_Profile_FullHistory_GdprWarning,
-            HellionStrings.Wizard_Profile_FullHistory_Apply,
-            ApplyFullHistory
-        );
-
-        ImGui.Spacing();
-        ImGui.Separator();
-        ImGui.Spacing();
-
-        if (ImGui.Button(HellionStrings.Wizard_Cancel_Label))
+        switch (_state.CurrentStep)
        {
-            Plugin.Config.FirstRunCompleted = true;
-            Plugin.SaveConfig();
-            IsOpen = false;
+            case 1:
+                DrawStepWelcome();
+                break;
+            case 2:
+                DrawStepPrivacy();
+                break;
+            case 3:
+                DrawStepPowerSettings();
+                break;
+            case 4:
+                DrawStepDone();
+                break;
+            default:
+                _state.CurrentStep = 1;
+                DrawStepWelcome();
+                break;
        }
-
-        if (ImGui.IsItemHovered())
-            ImGuiUtil.Tooltip(HellionStrings.Wizard_Cancel_Tooltip);
    }

-    private void DrawCard(
-        string id,
-        float width,
-        float height,
+    private void DrawPagination()
+    {
+        var draw = ImGui.GetWindowDrawList();
+        var avail = ImGui.GetContentRegionAvail();
+        var cursor = ImGui.GetCursorScreenPos();
+        const float radius = 5f;
+        const float spacing = 16f;
+        var totalWidth = (TotalSteps - 1) * spacing;
+        var startX = cursor.X + avail.X - totalWidth - radius;
+
+        for (var i = 0; i < TotalSteps; i++)
+        {
+            var color = (i + 1) == _state.CurrentStep ? ForgeBronze : ForgeBronzeDim;
+            var packed = ImGui.GetColorU32(color);
+            draw.AddCircleFilled(
+                new Vector2(startX + i * spacing, cursor.Y + radius),
+                radius,
+                packed
+            );
+        }
+
+        // Reserve vertical space the circles consumed so the next widget starts below them.
+        ImGui.Dummy(new Vector2(0, radius * 2));
+    }
+
+    private void DrawFooter(bool showBack, bool showSkip, string primaryLabel, Action onPrimary)
+    {
+        var spacing = ImGui.GetStyle().ItemSpacing.Y;
+        var primaryWidth =
+            ImGui.CalcTextSize(primaryLabel).X + ImGui.GetStyle().FramePadding.X * 2 + 16f;
+        var avail = ImGui.GetContentRegionAvail();
+
+        // Push the footer to the bottom of the window so step contents
+        // above can size themselves with GetContentRegionAvail().
+        var lineHeight = ImGui.GetFrameHeightWithSpacing();
+        var pushDown = avail.Y - lineHeight - spacing;
+        if (pushDown > 0)
+            ImGui.Dummy(new Vector2(0, pushDown));
+
+        ImGui.Separator();
+        ImGui.Spacing();
+
+        if (showBack)
+        {
+            if (ImGui.Button(HellionStrings.Wizard_Nav_Back))
+                _state.CurrentStep = Math.Max(1, _state.CurrentStep - 1);
+            ImGui.SameLine();
+        }
+
+        if (showSkip)
+        {
+            if (ImGui.Button(HellionStrings.Wizard_Step1_Skip_Label))
+            {
+                // Skip path = matches today's Cancel path: mark first-run
+                // complete, save, close. No CommitPending — the user said
+                // 'decide later', so existing config stays as-is.
+                Plugin.Config.FirstRunCompleted = true;
+                Plugin.SaveConfig();
+                IsOpen = false;
+            }
+            if (ImGui.IsItemHovered())
+                ImGuiUtil.Tooltip(HellionStrings.Wizard_Step1_Skip_Tooltip);
+        }
+
+        // Right-align the primary action button.
+        var rightX = ImGui.GetCursorPosX() + ImGui.GetContentRegionAvail().X - primaryWidth;
+        if (rightX > ImGui.GetCursorPosX())
+            ImGui.SameLine(rightX);
+
+        using (ImRaii.PushColor(ImGuiCol.Button, ForgeBronze))
+        using (ImRaii.PushColor(ImGuiCol.ButtonHovered, ForgeBronze))
+        using (ImRaii.PushColor(ImGuiCol.ButtonActive, ForgeBronze))
+        {
+            if (ImGui.Button($"{primaryLabel}##wizard-primary"))
+                onPrimary();
+        }
+    }
+
+    private void DrawStepWelcome()
+    {
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step1_Title);
+        ImGui.Spacing();
+
+        // Banner is opt-in: the full silhouette dominates the wizard window
+        // at the default size, so the TreeNode is folded by default and the
+        // onboarding copy stays the primary focus. Mirrors the pre-rewrite
+        // collapsible anchor from v1.5.1.
+        using (var tree = ImRaii.TreeNode("Hellion Forge"))
+        {
+            if (tree.Success)
+            {
+                using (Plugin.Interface.UiBuilder.MonoFontHandle.Push())
+                {
+                    // CalcTextSize must run inside the MonoFont push so the
+                    // measurement matches the glyph width actually used for
+                    // rendering.
+                    var bannerSize = ImGui.CalcTextSize(HellionForgeAscii.FoxBanner);
+                    ImGui.SetCursorPosX((ImGui.GetContentRegionAvail().X - bannerSize.X) * 0.5f);
+                    ImGui.TextUnformatted(HellionForgeAscii.FoxBanner);
+                }
+            }
+        }
+
+        ImGui.Spacing();
+        ImGui.TextWrapped(HellionStrings.Wizard_Step1_Subtitle);
+        ImGui.Spacing();
+        ImGui.TextWrapped(HellionStrings.Wizard_Step1_Footer_Hint);
+
+        DrawFooter(
+            showBack: false,
+            showSkip: true,
+            HellionStrings.Wizard_Nav_Next,
+            () => _state.CurrentStep = 2
+        );
+    }
+
+    private void DrawStepPrivacy()
+    {
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step2_Title);
+        ImGui.Spacing();
+
+        // Reserve footer height (separator + spacing + button row) so the
+        // 2x2 grid uses the rest of the window.
+        var footerReserve =
+            ImGui.GetFrameHeightWithSpacing()
+            + ImGui.GetStyle().ItemSpacing.Y * 3
+            + ImGui.GetTextLineHeight();
+        var grid = ImGui.GetContentRegionAvail();
+        var cardWidth = (grid.X - ImGui.GetStyle().ItemSpacing.X) / 2f;
+        var cardHeight = (grid.Y - footerReserve - ImGui.GetStyle().ItemSpacing.Y) / 2f;
+
+        // Top row.
+        DrawProfileCard(
+            PrivacyProfile.PrivacyFirst,
+            "🔒",
+            HellionStrings.Wizard_Profile_PrivacyFirst_Heading,
+            HellionStrings.Wizard_Profile_PrivacyFirst_Description,
+            recommended: false,
+            cardWidth,
+            cardHeight
+        );
+        ImGui.SameLine();
+        DrawProfileCard(
+            PrivacyProfile.Casual,
+            "💬",
+            HellionStrings.Wizard_Profile_Casual_Heading,
+            HellionStrings.Wizard_Profile_Casual_Description,
+            recommended: true,
+            cardWidth,
+            cardHeight
+        );
+
+        // Bottom row.
+        DrawProfileCard(
+            PrivacyProfile.Roleplay,
+            "🎭",
+            HellionStrings.Wizard_Profile_Roleplay_Heading,
+            HellionStrings.Wizard_Profile_Roleplay_Description,
+            recommended: false,
+            cardWidth,
+            cardHeight
+        );
+        ImGui.SameLine();
+        DrawProfileCard(
+            PrivacyProfile.FullHistory,
+            "📚",
+            HellionStrings.Wizard_Profile_FullHistory_Heading,
+            HellionStrings.Wizard_Profile_FullHistory_Description,
+            recommended: false,
+            cardWidth,
+            cardHeight
+        );
+
+        ImGui.Spacing();
+        ImGui.TextDisabled(HellionStrings.Wizard_Step2_RecommendedFooter);
+
+        DrawFooter(
+            showBack: true,
+            showSkip: true,
+            HellionStrings.Wizard_Nav_Next,
+            () => _state.CurrentStep = 3
+        );
+    }
+
+    private void DrawProfileCard(
+        PrivacyProfile profile,
+        string emoji,
        string heading,
        string description,
-        string? warning,
-        string buttonLabel,
-        Action onApply
+        bool recommended,
+        float width,
+        float height
    )
    {
-        using var child = ImRaii.Child($"##wizard-card-{id}", new Vector2(width, height), true);
+        var isSelected = _state.PendingProfile == profile;
+        // GetStyleColorVec4 returns a pointer to the live style entry in
+        // Dalamud.Bindings.ImGui, which would require unsafe. Use the U32
+        // packed-colour overload of PushColor for the default branch so we
+        // can stay in safe code while still matching the current border.
+        var borderColor = isSelected
+            ? ImGui.GetColorU32(ForgeBronze)
+            : ImGui.GetColorU32(ImGuiCol.Border);
+
+        using var _border = ImRaii.PushColor(ImGuiCol.Border, borderColor);
+        using var child = ImRaii.Child(
+            $"##profile-card-{profile}",
+            new Vector2(width, height),
+            true
+        );
        if (!child.Success)
            return;

-        ImGui.TextUnformatted(heading);
+        // InvisibleButton over the full card area, then SetCursorScreenPos
+        // back to draw the heading/description content on top. Selectable
+        // would be semantically wrong here — the card is a standalone
+        // choice tile, not a list-item inside a list/menu. The button
+        // takes the click for the entire card area, and IsItemHovered()
+        // on it (if we wire one up later) would naturally cover the full
+        // tile. Visual feedback comes from the border colour above.
+        var startPos = ImGui.GetCursorScreenPos();
+        var cardArea = ImGui.GetContentRegionAvail();
+        if (ImGui.InvisibleButton($"##profile-hit-{profile}", cardArea))
+            _state.PendingProfile = profile;
+
+        ImGui.SetCursorScreenPos(startPos);
+
+        ImGui.TextUnformatted($"{emoji}  {heading}{(recommended ? "  ★" : string.Empty)}");
+        ImGui.Spacing();
+        ImGui.Separator();
+        ImGui.Spacing();
+        ImGui.TextWrapped(description);
+    }
+
+    private void DrawStepPowerSettings()
+    {
+        // Seed only the two recommendation fields here. Other fields remain
+        // null until the user touches the corresponding control.
+        // Spec FR-4: the wizard explicitly recommends LoadPreviousSession =
+        // true and FilterIncludePreviousSessions = true (Config defaults are
+        // false). The other four fields (AutoTellTabsHistoryPreload,
+        // UseCompactDensity, PrettierTimestamps, Theme) follow the generic
+        // null-semantics from Spec Z.176: a null pending means the user did
+        // not touch that control, so CommitPending must not write back. They
+        // are read live from Plugin.Config below for the ImGui ref-binding
+        // but never seeded into Pending* without a user gesture.
+        _state.PendingLoadPreviousSession ??= true;
+        _state.PendingFilterIncludePreviousSessions ??= true;
+
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Title);
+        ImGui.Spacing();
+
+        // History section.
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Section_History);
+
+        var loadPrev = _state.PendingLoadPreviousSession ?? true;
+        if (ImGui.Checkbox(HellionStrings.Wizard_Step3_LoadPreviousSession_Label, ref loadPrev))
+        {
+            _state.PendingLoadPreviousSession = loadPrev;
+            // Mirror the DataManagement coupling: turning load-previous on
+            // also turns filter-include on (otherwise old messages bypass
+            // the filter chain), and turning filter-include off forces
+            // load-previous off. Same idiom as Ui/SettingsTabs/DataManagement.cs:182-200.
+            if (loadPrev)
+                _state.PendingFilterIncludePreviousSessions = true;
+        }
+
+        var filterPrev = _state.PendingFilterIncludePreviousSessions ?? true;
+        if (
+            ImGui.Checkbox(
+                HellionStrings.Wizard_Step3_FilterIncludePreviousSessions_Label,
+                ref filterPrev
+            )
+        )
+        {
+            _state.PendingFilterIncludePreviousSessions = filterPrev;
+            if (!filterPrev)
+                _state.PendingLoadPreviousSession = false;
+        }
+
+        ImGui.Spacing();
+
+        // Tell-Tabs section.
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Section_TellTabs);
+
+        var preload =
+            _state.PendingAutoTellTabsHistoryPreload ?? Plugin.Config.AutoTellTabsHistoryPreload;
+        if (
+            ImGui.SliderInt(
+                HellionStrings.Wizard_Step3_AutoTellTabsHistoryPreload_Label,
+                ref preload,
+                0,
+                100
+            )
+        )
+            _state.PendingAutoTellTabsHistoryPreload = preload;
+
+        ImGui.Spacing();
+
+        // Visual section.
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(HellionStrings.Wizard_Step3_Section_Visual);
+
+        var compact = _state.PendingUseCompactDensity ?? Plugin.Config.UseCompactDensity;
+        if (ImGui.Checkbox(HellionStrings.Wizard_Step3_UseCompactDensity_Label, ref compact))
+            _state.PendingUseCompactDensity = compact;
+
+        var pretty = _state.PendingPrettierTimestamps ?? Plugin.Config.PrettierTimestamps;
+        if (ImGui.Checkbox(HellionStrings.Wizard_Step3_PrettierTimestamps_Label, ref pretty))
+            _state.PendingPrettierTimestamps = pretty;
+
+        // Theme dropdown — built-ins only. Custom themes are power-user
+        // territory and would clutter the first-run flow.
+        var currentSlug = _state.PendingTheme ?? Plugin.Config.Theme;
+        var builtIns = Plugin.ThemeRegistry.AllBuiltIns().ToList();
+        var currentIndex = builtIns.FindIndex(t =>
+            string.Equals(t.Slug, currentSlug, StringComparison.OrdinalIgnoreCase)
+        );
+        if (currentIndex < 0)
+            currentIndex = 0;
+
+        using (
+            var combo = ImRaii.Combo(
+                HellionStrings.Wizard_Step3_Theme_Label,
+                builtIns[currentIndex].Name
+            )
+        )
+        {
+            if (combo.Success)
+            {
+                for (var i = 0; i < builtIns.Count; i++)
+                {
+                    var isSelected = i == currentIndex;
+                    if (ImGui.Selectable(builtIns[i].Name, isSelected))
+                        _state.PendingTheme = builtIns[i].Slug;
+                    if (isSelected)
+                        ImGui.SetItemDefaultFocus();
+                }
+            }
+        }
+
+        DrawFooter(
+            showBack: true,
+            showSkip: true,
+            HellionStrings.Wizard_Nav_Next,
+            () => _state.CurrentStep = 4
+        );
+    }
+
+    private void DrawStepDone()
+    {
+        ImGui.TextUnformatted(HellionStrings.Wizard_Step4_Title);
+        ImGui.Spacing();
+
+        // ✓ symbol, centred-ish via dummy padding.
+        var checkmark = "✓";
+        var checkSize = ImGui.CalcTextSize(checkmark);
+        var avail = ImGui.GetContentRegionAvail();
+        ImGui.Dummy(new Vector2((avail.X - checkSize.X) * 0.5f, 0));
+        ImGui.SameLine();
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextUnformatted(checkmark);
+
        ImGui.Spacing();
        ImGui.Separator();
        ImGui.Spacing();

-        ImGui.TextWrapped(description);
-
-        if (warning is not null)
+        // Summary card.
+        using (var summary = ImRaii.Child("##wizard-summary", new Vector2(-1, 130), true))
        {
-            ImGui.Spacing();
-            ImGuiUtil.WarningText(warning);
+            if (summary.Success)
+            {
+                ImGui.TextUnformatted(HellionStrings.Wizard_Step4_SummaryHeading);
+                ImGui.Spacing();
+                ImGui.Separator();
+                ImGui.Spacing();
+
+                var profileLabel = _state.PendingProfile switch
+                {
+                    PrivacyProfile.PrivacyFirst =>
+                        HellionStrings.Wizard_Profile_PrivacyFirst_Heading,
+                    PrivacyProfile.Casual => HellionStrings.Wizard_Profile_Casual_Heading,
+                    PrivacyProfile.Roleplay => HellionStrings.Wizard_Profile_Roleplay_Heading,
+                    PrivacyProfile.FullHistory => HellionStrings.Wizard_Profile_FullHistory_Heading,
+                    _ => HellionStrings.Wizard_Step4_Summary_Unchanged,
+                };
+                ImGui.TextWrapped(
+                    string.Format(HellionStrings.Wizard_Step4_Summary_Profile, profileLabel)
+                );
+
+                var historyLabel =
+                    (_state.PendingLoadPreviousSession ?? false)
+                        ? HellionStrings.Wizard_Step3_LoadPreviousSession_Label
+                        : HellionStrings.Wizard_Step4_Summary_Unchanged;
+                ImGui.TextWrapped(
+                    string.Format(HellionStrings.Wizard_Step4_Summary_History, historyLabel)
+                );
+
+                var preloadValue =
+                    _state.PendingAutoTellTabsHistoryPreload
+                    ?? Plugin.Config.AutoTellTabsHistoryPreload;
+                ImGui.TextWrapped(
+                    string.Format(HellionStrings.Wizard_Step4_Summary_TellTabs, preloadValue)
+                );
+
+                var compact = _state.PendingUseCompactDensity ?? Plugin.Config.UseCompactDensity;
+                var pretty = _state.PendingPrettierTimestamps ?? Plugin.Config.PrettierTimestamps;
+                var themeSlug = _state.PendingTheme ?? Plugin.Config.Theme;
+                var themeName = Plugin.ThemeRegistry.Get(themeSlug).Name;
+                var visualParts = new List<string>();
+                if (compact)
+                    visualParts.Add(HellionStrings.Wizard_Step3_UseCompactDensity_Label);
+                if (pretty)
+                    visualParts.Add(HellionStrings.Wizard_Step3_PrettierTimestamps_Label);
+                visualParts.Add(themeName);
+                ImGui.TextWrapped(
+                    string.Format(
+                        HellionStrings.Wizard_Step4_Summary_Visual,
+                        string.Join(", ", visualParts)
+                    )
+                );
+            }
        }

-        // Push the button to the bottom of the card.
-        var lineHeight = ImGui.GetFrameHeightWithSpacing();
-        var remaining = ImGui.GetContentRegionAvail().Y - lineHeight;
-        if (remaining > 0)
-            ImGui.Dummy(new Vector2(0, remaining));
+        ImGui.Spacing();

-        if (ImGui.Button($"{buttonLabel}##{id}", new Vector2(-1, 0)))
-        {
-            onApply();
-            Plugin.Config.FirstRunCompleted = true;
-            Plugin.SaveConfig();
-            IsOpen = false;
-        }
+        // Inline FR-3 hint with placeholder for preload count.
+        var preloadForHint =
+            _state.PendingAutoTellTabsHistoryPreload ?? Plugin.Config.AutoTellTabsHistoryPreload;
+        using (ImRaii.PushColor(ImGuiCol.Text, ForgeBronze))
+            ImGui.TextWrapped(string.Format(HellionStrings.Wizard_Step4_TestHint, preloadForHint));
+
+        ImGui.Spacing();
+        ImGui.TextDisabled(HellionStrings.Wizard_Step4_SettingsHint);
+
+        DrawFooter(
+            showBack: true,
+            showSkip: false,
+            HellionStrings.Wizard_Nav_Finish,
+            () =>
+            {
+                CommitPending();
+                Plugin.Config.FirstRunCompleted = true;
+                Plugin.SaveConfig();
+                IsOpen = false;
+            }
+        );
    }

-    // Collapsible because the full silhouette is taller than the wizard
-    // window — folded by default so the privacy cards stay the primary
-    // focus, expandable for whoever wants the "about the makers" anchor.
-    private void DrawHellionForgeAnchor()
+    // Writes only non-null pending values back to Config. A null pending
+    // means the user did not touch that step's control, so the existing
+    // Config value is preserved. Theme switch goes through ThemeRegistry
+    // so the active palette updates live for the rest of the session.
+    internal void CommitPending()
    {
-        using var tree = ImRaii.TreeNode("Hellion Forge");
-        if (!tree.Success)
-            return;
+        switch (_state.PendingProfile)
+        {
+            case PrivacyProfile.PrivacyFirst:
+                ApplyPrivacyFirst();
+                break;
+            case PrivacyProfile.Casual:
+                ApplyCasual();
+                break;
+            case PrivacyProfile.Roleplay:
+                ApplyRoleplay();
+                break;
+            case PrivacyProfile.FullHistory:
+                ApplyFullHistory();
+                break;
+        }

-        using (Plugin.Interface.UiBuilder.MonoFontHandle.Push())
-            ImGui.TextUnformatted(HellionForgeAscii.FoxBanner);
+        if (_state.PendingLoadPreviousSession.HasValue)
+            Plugin.Config.LoadPreviousSession = _state.PendingLoadPreviousSession.Value;
+
+        if (_state.PendingFilterIncludePreviousSessions.HasValue)
+            Plugin.Config.FilterIncludePreviousSessions = _state
+                .PendingFilterIncludePreviousSessions
+                .Value;
+
+        if (_state.PendingAutoTellTabsHistoryPreload.HasValue)
+            Plugin.Config.AutoTellTabsHistoryPreload = _state
+                .PendingAutoTellTabsHistoryPreload
+                .Value;
+
+        if (_state.PendingUseCompactDensity.HasValue)
+            Plugin.Config.UseCompactDensity = _state.PendingUseCompactDensity.Value;
+
+        if (_state.PendingPrettierTimestamps.HasValue)
+            Plugin.Config.PrettierTimestamps = _state.PendingPrettierTimestamps.Value;
+
+        if (!string.IsNullOrWhiteSpace(_state.PendingTheme))
+        {
+            Plugin.Config.Theme = _state.PendingTheme;
+            Plugin.ThemeRegistry.Switch(_state.PendingTheme);
+        }
    }

    private void ApplyPrivacyFirst()
@@ -194,6 +614,20 @@ public sealed class FirstRunWizard : Window
        Plugin.Config.RetentionPerChannelDays = policy;
    }

+    private void ApplyRoleplay()
+    {
+        Plugin.Config.PrivacyFilterEnabled = true;
+        Plugin.Config.PrivacyPersistChannels = [.. PrivacyDefaults.RoleplayWhitelist];
+        Plugin.Config.PrivacyPersistUnknownChannels = false;
+
+        Plugin.Config.RetentionEnabled = true;
+        Plugin.Config.RetentionDefaultDays = 30;
+        var policy = PrivacyDefaults.DefaultRetentionDays.ToDictionary(p => p.Key, p => p.Value);
+        foreach (var (type, days) in PrivacyDefaults.RoleplayRetentionOverrides)
+            policy[type] = days;
+        Plugin.Config.RetentionPerChannelDays = policy;
+    }
+
    private void ApplyFullHistory()
    {
        // Full history = upstream Chat 2 behavior. Filter off, retention off,
@@ -205,4 +639,34 @@ public sealed class FirstRunWizard : Window
        Plugin.Config.RetentionEnabled = false;
        Plugin.Config.RetentionPerChannelDays.Clear();
    }
+
+    // Test-only entry point so SelfTests/WizardStateSmokeStep can advance
+    // the state machine without spawning ImGui input events.
+    internal void TestOnly_AdvanceTo(int step) =>
+        _state.CurrentStep = Math.Clamp(step, 1, TotalSteps);
+
+    // Test-only setter so the smoke-test can pin a profile selection
+    // without driving the ImGui card-click path.
+    internal void TestOnly_SetPendingProfile(PrivacyProfile profile) =>
+        _state.PendingProfile = profile;
+
+    internal enum PrivacyProfile
+    {
+        PrivacyFirst,
+        Casual,
+        Roleplay,
+        FullHistory,
+    }
+
+    private sealed class WizardState
+    {
+        public int CurrentStep { get; set; } = 1;
+        public PrivacyProfile? PendingProfile { get; set; }
+        public bool? PendingLoadPreviousSession { get; set; }
+        public bool? PendingFilterIncludePreviousSessions { get; set; }
+        public int? PendingAutoTellTabsHistoryPreload { get; set; }
+        public bool? PendingUseCompactDensity { get; set; }
+        public bool? PendingPrettierTimestamps { get; set; }
+        public string? PendingTheme { get; set; }
+    }
 }
@@ -33,11 +33,31 @@ internal static class HellionStyle

    // Global color and style stack pushed once per frame.
    // windowOpacity: window background alpha (0.5-1.0).
-    internal static IDisposable PushGlobal(Theme theme, float windowOpacity = 1.0f)
+    internal static IDisposable PushGlobal(
+        Theme theme,
+        ThemeRegistry registry,
+        float windowOpacity = 1.0f
+    )
    {
        var c = theme.Colors;
        var l = theme.Layout;
-        var a = theme.AbgrCache;
+
+        // Crossfade: PM-1 reads a lerped snapshot during the 300ms window
+        // following a Switch (TryGetActiveCrossfade returns false outside
+        // the window or while ReduceMotion is on). Only the ABGR-slot path
+        // crossfades -- WindowBg/ChildBg RGBA stays bound to the user's
+        // per-window opacity override and must not fade. See
+        // feedback_dalamud_pinning_override.
+        ThemeAbgrCache a;
+        if (!Plugin.Config.ReduceMotion && registry.TryGetActiveCrossfade(out var lerped))
+        {
+            a = lerped;
+        }
+        else
+        {
+            a = theme.AbgrCache;
+        }
+
        var stack = new StackHandle();

        var alphaByte = (uint)Math.Clamp((int)(windowOpacity * 255f), 0x55, 0xFF);
@@ -201,6 +201,18 @@ public sealed class SettingsWindow : Dalamud.Interface.Windowing.Window

        var hideChanged = !Mutable.HideChat && Mutable.HideChat != Plugin.Config.HideChat;
        var languageChanged = Mutable.LanguageOverride != Plugin.Config.LanguageOverride;
+
+        // v1.5.3: Auto-enable the ExtraGlyphRanges flag matching the new
+        // locale so non-Latin scripts render immediately. Without this,
+        // a user switching to Korean would see "===" until they manually
+        // tick the Korean range in Fonts & Colours.
+        if (languageChanged)
+        {
+            var required = Mutable.LanguageOverride.RequiredGlyphRanges();
+            if (required != 0)
+                Mutable.ExtraGlyphRanges |= required;
+        }
+
        var fontChanged =
            Mutable.GlobalFontV2 != Plugin.Config.GlobalFontV2
            || Mutable.JapaneseFontV2 != Plugin.Config.JapaneseFontV2
@@ -54,28 +54,23 @@ internal sealed class FontsAndColours : ISettingsTab

            if (Mutable.UseHellionFont)
            {
+                // Bundled-font path: only the base font size matters; the
+                // global / japanese / italic chooser pickers do not apply.
                ImGuiUtil.FontSizeCombo(Language.Options_FontSize_Name, ref Mutable.FontSizeV2);
                ImGui.Spacing();
-
-                ImGuiUtil.FontSizeCombo(
-                    Language.Options_SymbolsFontSize_Name,
-                    ref Mutable.SymbolsFontSizeV2
-                );
-                ImGuiUtil.HelpMarker(Language.Options_SymbolsFontSize_Description);
-
+            }
+            else
+            {
+                ImGui.Checkbox(Language.Options_FontsEnabled, ref Mutable.FontsEnabled);
                ImGui.Spacing();
-                return;
            }

-            ImGui.Checkbox(Language.Options_FontsEnabled, ref Mutable.FontsEnabled);
-            ImGui.Spacing();
-
            var unused = false;
-            if (!Mutable.FontsEnabled)
+            if (!Mutable.UseHellionFont && !Mutable.FontsEnabled)
            {
                ImGuiUtil.FontSizeCombo(Language.Options_FontSize_Name, ref Mutable.FontSizeV2);
            }
-            else
+            else if (!Mutable.UseHellionFont)
            {
                var globalChooser = ImGuiUtil.FontChooser(
                    Language.Options_Font_Name,
@@ -164,23 +159,25 @@ internal sealed class FontsAndColours : ISettingsTab
                    string.Format(Language.Options_Italic_Description, Plugin.PluginName)
                );
                ImGui.Spacing();
+            }

-                if (ImGui.CollapsingHeader(Language.Options_ExtraGlyphs_Name))
+            // v1.5.3: ExtraGlyphRanges is an atlas-wide property and stays
+            // reachable regardless of UseHellionFont / FontsEnabled state so
+            // users can verify or override the auto-activation on language change.
+            ImGui.Spacing();
+            if (ImGui.CollapsingHeader(Language.Options_ExtraGlyphs_Name))
+            {
+                ImGuiUtil.HelpMarker(
+                    string.Format(Language.Options_ExtraGlyphs_Description, Plugin.PluginName)
+                );
+
+                var range = (int)Mutable.ExtraGlyphRanges;
+                foreach (var extra in Enum.GetValues<ExtraGlyphRanges>())
                {
-                    ImGuiUtil.HelpMarker(
-                        string.Format(Language.Options_ExtraGlyphs_Description, Plugin.PluginName)
-                    );
-
-                    var range = (int)Mutable.ExtraGlyphRanges;
-                    foreach (var extra in Enum.GetValues<ExtraGlyphRanges>())
-                    {
-                        ImGui.CheckboxFlags(extra.Name(), ref range, (int)extra);
-                    }
-
-                    Mutable.ExtraGlyphRanges = (ExtraGlyphRanges)range;
+                    ImGui.CheckboxFlags(extra.Name(), ref range, (int)extra);
                }

-                ImGui.Spacing();
+                Mutable.ExtraGlyphRanges = (ExtraGlyphRanges)range;
            }

            ImGuiUtil.FontSizeCombo(
@@ -139,7 +139,12 @@ internal sealed class General : ISettingsTab
            {
                if (combo.Success)
                {
-                    foreach (var language in Enum.GetValues<LanguageOverride>())
+                    // None pinned first, then alphabetical by endonym so source order
+                    // (append-only for serialisation safety) is not visible to users.
+                    var sortedLanguages = Enum.GetValues<LanguageOverride>()
+                        .OrderBy(l => l == LanguageOverride.None ? 0 : 1)
+                        .ThenBy(l => l.Name(), StringComparer.InvariantCulture);
+                    foreach (var language in sortedLanguages)
                    {
                        if (ImGui.Selectable(language.Name()))
                        {
@@ -151,6 +156,9 @@ internal sealed class General : ISettingsTab
            ImGuiUtil.HelpMarker(
                string.Format(Language.Options_Language_Description, Plugin.PluginName)
            );
+            // v1.5.3: HellionChat's font stack covers 24 languages but FFXIV's
+            // engine only supports EN/DE/FR/JA for chat input/sending.
+            ImGuiUtil.WarningText(HellionStrings.Settings_Language_FFXIVCoverage_Warning);
            ImGui.Spacing();

            using (
@@ -295,6 +295,20 @@ internal sealed class ThemeAndLayout : ISettingsTab
                Mutable.WindowOpacity = opacityPercent / 100f;
            }
            ImGuiUtil.HelpMarker(HellionStrings.Settings_ThemeAndLayout_WindowOpacity_Description);
+
+            ImGui.Spacing();
+            ImGui.Separator();
+            ImGui.Spacing();
+
+            // Master accessibility toggle for the v1.5.4 motion work: the
+            // theme crossfade, the sidebar/card hover lerps and the
+            // unread-tab pulse all read Config.ReduceMotion and snap
+            // instantly when it is on.
+            ImGui.Checkbox(
+                HellionStrings.Settings_ThemeAndLayout_ReduceMotion_Name,
+                ref Mutable.ReduceMotion
+            );
+            ImGuiUtil.HelpMarker(HellionStrings.Settings_ThemeAndLayout_ReduceMotion_Description);
        }
    }

@@ -66,6 +66,18 @@ internal static class ColourUtil
        return ((uint)a << 24) | ((uint)nb << 16) | ((uint)ng << 8) | nr;
    }

+    // Modulates the alpha byte of an ABGR color by a factor in [0, 1].
+    // RGB stays intact. Used by the PM-3 hover-lerp path where each
+    // frame produces a fractional alpha value but the colour itself
+    // must not shift.
+    internal static uint ApplyAlpha(uint abgr, float alphaFactor)
+    {
+        alphaFactor = Math.Clamp(alphaFactor, 0f, 1f);
+        var origAlpha = (byte)((abgr >> 24) & 0xFFu);
+        var newAlpha = (byte)Math.Round(origAlpha * alphaFactor);
+        return (abgr & 0x00FFFFFFu) | ((uint)newAlpha << 24);
+    }
+
    public static uint HexToRgba(string hex)
    {
        ArgumentNullException.ThrowIfNull(hex);
@@ -0,0 +1,17 @@
+namespace HellionChat.Util;
+
+// Framerate-independent smoothing for per-frame hover and motion
+// values. Pattern anchor: Umbra Toolbar.Autohide.cs:55
+// (`v += (target - v) * deltaTime`). The Math.Min(1f, speed*dt)
+// clamp is a deliberate HellionChat addition -- on Wine/DXVK a
+// stalled frame can push deltaTime well over 16ms, which would
+// otherwise let the raw factor exceed 1.0 and overshoot the target.
+// Clamping makes a stalled frame land exactly on target instead.
+internal static class FrameLerp
+{
+    public static float Smooth(float current, float target, float speed, float deltaTime)
+    {
+        var factor = Math.Min(1f, speed * deltaTime);
+        return current + (target - current) * factor;
+    }
+}
@@ -2,7 +2,7 @@

 [![Build](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/actions/workflows/build.yml/badge.svg?branch=main)](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/actions/workflows/build.yml)
 [![License: EUPL-1.2](https://img.shields.io/badge/License-EUPL--1.2-blue.svg)](LICENSE)
-[![Latest release](https://img.shields.io/badge/release-v1.5.1-brightgreen)](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/releases/latest)
+[![Latest release](https://img.shields.io/badge/release-v1.5.4-brightgreen)](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/releases/latest)
 [![Dalamud API](https://img.shields.io/badge/Dalamud-API_15-purple)](https://github.com/goatcorp/Dalamud)
 [![.NET](https://img.shields.io/badge/.NET-10.0-512BD4)](https://dotnet.microsoft.com/)
 [![FFXIV](https://img.shields.io/badge/FFXIV-Dawntrail-c3a37f)](https://www.finalfantasyxiv.com/)
@@ -11,7 +11,7 @@
  <img src="docs/images/hellion-forge.png" alt="Hellion Forge" width="180" />
 </p>

-**Version 1.5.1** — Privacy-first chat plugin for FINAL FANTASY XIV / Dalamud, built on
+**Version 1.5.4** — Privacy-first chat plugin for FINAL FANTASY XIV / Dalamud, built on
 [Chat 2](https://github.com/Infiziert90/ChatTwo) (EUPL-1.2).

 Hellion Chat is a privacy-first plugin built on the Chat 2 foundation. The majority of the engine
@@ -55,7 +55,7 @@ Hellion Chat is developed under **Hellion Forge**, the specialized modding and p
 | UI           | Dear ImGui (Dalamud bindings)                       |
 | Database     | SQLite (Microsoft.Data.Sqlite, MessagePack storage) |
 | Localization | ResX (HellionStrings.resx, .de.resx; PR-based)      |
-| Font         | Exo 2 (SIL Open Font License 1.1, bundled)          |
+| Font         | Inter Light (SIL Open Font License 1.1, bundled)    |
 | Toolchain    | dotnet 10 SDK, VS Code with C# Dev Kit              |
 | Deployment   | GitHub Releases + custom repo (`repo.json`)         |

@@ -103,7 +103,7 @@ Hellion Chat is developed under **Hellion Forge**, the specialized modding and p
  Colors: Classic (Chat 2 default), High Contrast, Pastel, Dark Mode Tuned, Hellion (brand), plus
  bonus moods Night Blue and Indigo Violet. One-click apply, battle channels remain untouched.
 - **Window opacity slider** for combat-friendly transparency.
- **Bundled Hellion font** (Exo 2, OFL-1.1) as an optional default instead of the system font.
+- **Bundled UI font** (Inter Light, OFL-1.1) as an optional default instead of the system font.
 - **Hellion logo** bundled in the plugin and displayed in the Dalamud plugin list.

 #### Custom Themes (v1.1.0)
@@ -164,8 +164,8 @@ HellionChat/
 │   ├── HellionStrings.de.resx   # German translation
 │   ├── HellionStrings.Designer.cs # Hand-maintained accessor
 │   ├── ChatColourPresets.cs     # Seven built-in color presets (v0.6.0)
-│   ├── HellionFont.ttf          # Exo 2 variable font
-│   ├── HellionFont-OFL.txt      # OFL-1.1 license text (bundled with font)
+│   ├── Inter-Light.ttf          # Inter Light static font (bundled UI font)
+│   ├── Inter-OFL.txt            # OFL-1.1 license text (bundled with font)
 │   └── Language*.resx           # Upstream localization (Crowdin)
 ├── Ui/
 │   ├── FirstRunWizard.cs        # Three-profile onboarding
@@ -299,6 +299,58 @@ An optional submission to the Dalamud main plugin repo (in addition to the custo

 ## Project Status

+**Version 1.5.4** — Polish and Motion. Theme switches now crossfade smoothly over
+~300 ms across every Hellion-rendered surface — sidebar, title, buttons, tabs,
+scrollbar, separators. The window background snaps deliberately so the per-window
+opacity override from Dalamud's pinning menu stays intact. A new header quick-picker —
+a palette button left of the cog — opens a compact popup that switches themes and tabs
+without opening Settings; the active entry carries a check glyph and the popup stays
+open between picks. Sidebar icons ease their opacity on hover and card-mode message
+borders highlight per tab, both framerate-independent so a stalled Wine frame cannot
+overshoot. A new "Reduce motion" toggle in Theme & Layout disables the crossfade, the
+hover animations and the unread-tab pulse for users who prefer a static UI. No schema
+bump, migration v17 stays.
+
+---
+
+### Project status (pre-v1.5.4, kept for context)
+
+**Version 1.5.3** — Localisation Wave + Bundled-Font Overhaul. Twenty-four selectable UI languages
+(Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hungarian, Italian,
+Japanese, Korean, Norsk bokmål, Polish, Portuguese (Brazil), Portuguese (Portugal), Romanian,
+Russian, Spanish, Swedish, Turkish, Ukrainian, Simplified Chinese, Traditional Chinese); dropdown
+sorts alphabetically by endonym, "None" pinned first. Non-native translations are AI-assisted and
+flagged for community native-speaker review. The bundled UI font swaps from Exo 2 to **Inter
+Light** (SIL OFL 1.1, 343 KB) for wider Latin Extended-A/B, Greek polytonic and Cyrillic Supplement
+coverage. **NotoSansCjkRegular** joins as a third merge layer so Hangul and Simplified-Chinese
+glyphs the FFXIV Japanese game font does not ship now render correctly. First-frame HITCH dropped
+from ~74 ms (v1.5.2 baseline that held since v1.4.x) 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.
+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 in-game. Migration v17 stays.
+
+---
+
+**Version 1.5.2** — First-Run Wizard Rework. The single-page wizard becomes a four-step
+staged-commit flow (Welcome → Privacy → Power Settings → Done). The privacy picker becomes a 2×2
+grid with a fourth profile "Roleplay" that extends Privacy-First with `Say` and both emote types
+under a 30-/90-day retention window. A power-settings stage surfaces six previously-hidden
+`Configuration` defaults in one place without introducing any new settings. The wizard window
+shrinks to 720×480 default (was 900×560, MinimumSize 600×400) after smoke feedback and Step 1
+keeps the fox banner in a folded TreeNode so the onboarding copy stays primary. Existing v1.5.1
+users see the new flow once on first v1.5.2 boot via a new `WizardLastShownVersion` config marker.
+Under the hood: a `WizardStateSmokeStep` joins `/xlperf`, the Build Suite gains twelve pure-helper
+xUnit Facts pinning all four privacy profile sets and the new Roleplay retention overrides.
+Migration v17 stays — `Configuration` only grows one optional string field.
+
+---
+
+### Project status (pre-v1.5.2, kept for context)
+
 **Version 1.5.1** — FontAtlas Refactor and Hellion Forge Signature. The FontManager moves from the
 inherited Chat 2 anti-pattern (null! fields + a separate BuildFonts method) to a hybrid model where
 the game fonts and FontAwesome are init-only handles and only the user-configurable delegate fonts
@@ -318,10 +370,6 @@ defer their font-atlas build to land at ~7 ms; Chat 2 + HellionChat were ~75 ms)
 cost lives in the UiBuilder first-frame render path, not in the atlas build. A first-frame render
 investigation is reserved for a later cycle.

---
-
-### Project status (pre-v1.5.1, kept for context)
-
 **Version 1.5.0** — DI Foundation and Service Refactor. Major architecture cycle: the plugin
 bootstrap moves to a generic-host DI container (`Microsoft.Extensions.Hosting` +
 `IServiceCollection`) modelled on Lightless Sync. All 18 instance-class services migrate from a
@@ -345,7 +393,7 @@ Hellion Chat is a standalone plugin, no longer a fork in the repository sense. F
 - First-run wizard with three profiles
 - Plugin identity: own `HellionChat` slot, layout migration from Chat 2, Migrate3 recovery
 - Bilingual UI (EN and DE) with live language switching
- Hellion theme, Hellion logo, bundled Exo 2 font
+- Hellion theme, Hellion logo, bundled Inter Light font
 - Custom repo pipeline with automated GitHub Release distribution
 - Slash commands consolidated to the `/hellionchat` family
 - Web interface removed (v0.2.0)
@@ -11,6 +11,152 @@ releases as an overview and links to the release pages for details.

 ---

+## Hellion Chat 1.5.4 — Polish and Motion (2026-05-20)
+
+A polish cycle of three P3 items. Theme switches now crossfade smoothly over ~300 ms
+across every Hellion-rendered surface; the window background snaps deliberately so the
+per-window opacity override from Dalamud's pinning menu stays intact. A new header
+quick-picker — a palette button left of the cog — opens a compact popup for switching
+themes and tabs without opening Settings. Sidebar icons and card-mode message borders
+gain framerate-independent hover animations. A new "Reduce motion" toggle in Theme &
+Layout disables the crossfade, hover animations and unread-tab pulse for accessibility.
+No schema bump, migration v17 stays.
+
+## Hellion Chat 1.5.3 — Localisation Wave + Bundled-Font Overhaul (2026-05-19)
+
+Multi-language pass plus a long-standing first-frame HITCH lands as a side effect of a font-stack
+rewrite. The bundled UI font swaps from Exo 2 to Inter Light. HellionChat now ships strings and
+renderable glyph coverage for 24 languages.
+
+### User-visible
+
+- Twenty-four selectable UI languages: Catalan, Czech, Danish, Dutch, English, Finnish, French,
+  German, Greek, Hungarian, Italian, Japanese, Korean, Norsk bokmål, Polish, Portuguese (Brazil),
+  Portuguese (Portugal), Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian, Simplified
+  Chinese, Traditional Chinese. The dropdown sorts alphabetically by endonym, "None" pinned first.
+  Non-native translations are AI-assisted and flagged for community native-speaker review via the
+  Hellion Forge Discord.
+- Bundled **Inter Light** replaces Exo 2 as the in-plugin font. Wider European coverage (Latin
+  Extended-A/B, Greek polytonic, Cyrillic Supplement) so Czech, Polish, Romanian, Turkish,
+  Hungarian, Greek and Ukrainian render without manual font configuration. SIL OFL 1.1, 343 KB.
+- **NotoSansCjkRegular fallback** layer added as a merge-on-top so Hangul, Simplified-Chinese
+  characters specific to the post-1956 reform, and other CJK glyphs the FFXIV Japanese game font
+  does not ship now render correctly inside the HellionChat UI.
+- First-frame **HITCH dropped from ~74 ms** (the v1.5.2 baseline that has held since v1.4.x) to a
+  **median of ~20 ms** (5-reload sample: 23.6 / 20.4 / 17.9 / 20.1 / 19.2 ms, Linux/Wine; Windows
+  baseline pending Jin's verification per the cross-platform-pflicht). The bundled-font path
+  silently fell back to the FFXIV Axis game font for the entire v1.5.x series because of an
+  early-return in the draw loop. The fix that routes `RegularFont` through draw also lands the
+  defer-pattern win the v1.5.1 cycle was reaching for.
+- **ExtraGlyphRanges activates automatically** when the user picks a language that needs a non-Latin
+  script. Selecting Korean enables the Korean glyph range and rebuilds the atlas without a manual
+  toggle in Fonts & Colours.
+- New **WarningText under the language dropdown** notes that FFXIV's own chat input only fully
+  supports EN, DE, FR and JA character sets. Other languages render inside HellionChat but may
+  garble when typed into in-game chat or sent as messages.
+
+### Under the hood
+
+- Three-layer font stack in `FontManager.BuildRegularFontHandle` and `BuildItalicFontHandle`:
+  Inter Light (or the user-selected global font) as primary, FFXIV JapaneseFont as merge 1 for
+  native FFXIV kana/kanji style, NotoSansCjkRegular as merge 2 for everything else CJK.
+- Two new `ExtraGlyphRanges` flags: `LatinExtended` (U+0100-U+024F) and `Greek` (U+0370-U+03FF +
+  U+1F00-U+1FFF). Implemented as `builder.AddChar` pair lists in `SetUpRanges` (no managed-pointer
+  pinning needed).
+- `LanguageOverride` enum gains ten locales (Catalan, Czech, Danish, Finnish, Hungarian,
+  Norwegian, Polish, Portuguese (Portugal), Turkish, Ukrainian) plus three previously
+  commented-out entries (Italian, Korean, Norwegian re-enabled with code `nb` instead of `no`).
+  New values are appended to the enum to keep existing user-config integer serialisation stable.
+- **Crowdin gap closed:** four ChatTwo keys added after the last community sync
+  (`Options_ColorSelectedInputChannelButton_Name` / `_Description`,
+  `Options_HideInNewGamePlusMenu_Name` / `_Description`) are now backfilled into the thirteen
+  legacy Crowdin locales with per-key AI-translated markers.
+- Plugin init runs a one-shot migration that ORs in the matching `ExtraGlyphRanges` flag based on
+  the user's current `LanguageOverride`. An update from v1.5.2 picks up the new coverage without
+  the user having to toggle the language twice.
+- `Plugin.cs:937` draw-path fixed: `RegularFont` is now pushed whenever **either** `FontsEnabled`
+  **or** `UseHellionFont` is on. The previous `Config.FontsEnabled`-only check meant the bundled
+  font path was silently dead whenever `FontsAndColours.cs:50` force-set `FontsEnabled = false` on
+  the UseHellionFont-toggle. Source of the HITCH win.
+- `ExtraGlyphRanges` settings panel is now reachable in **all** UseHellionFont / FontsEnabled
+  combinations. The bundled-font branch used to short-circuit past it.
+- **Resource bundle split:** fork-added strings live in `HellionStrings.resx` (24 locales, 328
+  keys each) alongside the ChatTwo-Crowdin-heritage `Language.resx` (24 locales, 456 keys each).
+  The `Language` siblings for the ten brand-new locales and Greek carry a Hellion Forge maintainer
+  header that points reviewers at the Discord rather than the standalone-hosted Gitea.
+- **Em-dash sweep** across the EN source and 18 translations: in-prose em-dashes replaced with
+  period or colon per the house style guide. Russian and Ukrainian keep their typographic norm
+  where the em-dash is orthographically required (subject-predicate separator).
+- **Bundled font asset rotation:** `HellionFont.ttf` (Exo 2) plus its OFL notice removed from
+  `Resources/`. `Inter-Light.ttf` plus `Inter-OFL.txt` take their place. `FontManager`
+  references rename to `BundledFontBytes` / `TryGetBundledFontBytes()` for clarity (config field
+  `UseHellionFont` keeps its name so existing user configs deserialize cleanly).
+
+### Migration
+
+- Migration v17 stays (no schema bump).
+- Existing `UseHellionFont = true` users transition transparently from Exo 2 to Inter Light on
+  first reload.
+- Existing users with `LanguageOverride != None` get their matching `ExtraGlyphRanges` flag set
+  on the first plugin init after the v1.5.3 update (Plugin.cs LoadAsync migration step).
+
+### Reserved for follow-up cycles
+
+- Native-speaker review pass for AI-assisted translations in the 13 legacy Crowdin locales (ca,
+  es, fr, it, ja, ko, nl, pt-BR, ro, ru, sv, zh-Hans, zh-Hant) — corrections via the Hellion
+  Forge Discord.
+
+Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
+
+---
+
+## Hellion Chat 1.5.2 — First-Run Wizard Rework (2026-05-18)
+
+UX patch. The single-page first-run wizard becomes a four-step staged-commit flow, the privacy
+profile catalogue gains a fourth entry "Roleplay", and a new power-settings stage surfaces six
+previously-hidden Configuration defaults. Existing v1.5.1 users see the new wizard once on first
+v1.5.2 boot via a new `WizardLastShownVersion` config marker.
+
+User-visible:
+
+- Wizard layout: Welcome → Privacy profile → Power settings → Done. Forge-Bronze pagination dots,
+  per-step Back / Decide later / Next footer. Decide-later and X-close both leave the existing
+  config untouched; only the Finish ✓ click commits pending choices.
+- Fourth privacy profile "Roleplay": Privacy-First whitelist plus `Say` and both emote types, with a
+  30-day retention window for `Say` and 90 days for the two emote channels. `Shout`, `Yell` and
+  `NoviceNetwork` stay out — public-distance noise from strangers is not story content.
+- Privacy picker becomes a 2×2 grid. Casual stays the recommended option with a ★ marker.
+- Power-settings stage surfaces six existing `Configuration` fields in one place: Load Previous
+  Session, Filter Include Previous Sessions, Auto-Tell-Tabs History Preload, Compact Density,
+  Prettier Timestamps, plus a built-in theme picker. No new settings are introduced — the stage just
+  collects what was previously buried in Settings → Privacy / Chat / Data Management / Appearance.
+- Inline test hint on the done stage: `type /tell <Player Name> into chat` surfaces the auto-tell-tab
+  spawn mechanism for new users.
+- Wizard window starts at 720×480 (was 900×560) and can shrink to 600×400. Step 1 wraps the fox
+  banner in a collapsible TreeNode, folded by default — onboarding copy stays primary.
+- Existing v1.5.1 users get the new wizard surfaced once on first v1.5.2 boot. A new
+  `WizardLastShownVersion` config field tracks the most recent version whose wizard was shown;
+  Plugin.LoadAsync resets `FirstRunCompleted` once when the constant `1.5.2` doesn't match.
+
+Under the hood:
+
+- `WizardStateSmokeStep` registered with `/xlperf`. Variant 1 walks the four steps with empty
+  pending state to pin the no-op CommitPending path. Variant 2 picks Roleplay on Step 2, skips
+  Step 3, commits, and asserts `LoadPreviousSession` / `FilterIncludePreviousSessions` stayed on
+  their pre-test value — pinning the null-semantics contract. The step snapshots six privacy /
+  retention fields before Variant 2 and `CleanUp()` restores them, so back-to-back runs don't drift
+  the active profile.
+- Twelve pure-helper xUnit Facts in the Build Suite (`Privacy/PrivacyDefaultsTests.cs`) cover all
+  four profile whitelists plus the new Roleplay retention overrides.
+- `Configuration` grows one optional string field `WizardLastShownVersion` (default empty). No
+  schema bump — migration v17 still applies.
+
+Based on Chat 2 1.35.3 (upstream Infiziert90/ChatTwo, EUPL-1.2).
+
+[Full release notes on the Gitea release page.](https://gitea.hellion-forge.cloud/JonKazama-Hellion/HellionChat/releases/tag/v1.5.2)
+
+---
+
 ## Hellion Chat 1.5.1 — FontAtlas Refactor and Hellion Forge Signature (2026-05-17)

 Hybrid FontManager refactor plus an embedded Hellion Forge provenance mark.
@@ -10,14 +10,75 @@ be a poor fit for the plugin's privacy-first scope during brainstorming.

 ---

-## Next Cycle (v1.5.2)
+## Next Cycle

-**First-Run-Wizard rework with curated defaults beyond the three privacy profiles.** Jin's discovery
-in v1.4.10 surfaced the wizard's three-card layout as too thin — power users want richer presets out
-of the box. After that, FR localisation (Hezcal native-speaker review confirmed), then the Plugin
-Integrations Wave 2-6 (Context-Menu, NotificationMaster, Moodles, ExtraChat, XIVIM Quick-DM). The
-UiBuilder first-frame HITCH investigation that v1.5.1 surfaced sits as a separate spike near the
-Wine/Linux scroll-rubber-band investigation 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.4 — Polish and Motion (released 2026-05-20)
+
+A polish cycle of three P3 items. Theme switches crossfade over ~300 ms across every
+Hellion-rendered surface; the window background snaps deliberately to preserve the
+per-window opacity override from Dalamud's pinning menu. A header quick-picker — a
+palette button left of the cog — switches themes and tabs from a compact popup without
+opening Settings. Sidebar icons and card-mode borders gain framerate-independent hover
+animations. A new "Reduce motion" toggle in Theme & Layout covers accessibility. No
+schema bump; migration v17 stays.
+
+---
+
+## 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.
+
+---
+
+## v1.5.2 — First-Run Wizard Rework (released 2026-05-18)
+
+Multi-step wizard replacement: Welcome → Privacy → Power Settings → Done with staged-commit so
+Decide-later or X-close at any point leaves the existing config untouched. New fourth privacy
+profile "Roleplay" extends Privacy-First with `Say` and both emote types under a 30-/90-day
+retention window. Privacy picker becomes a 2×2 grid; Casual keeps the ★ recommended marker. A new
+power-settings stage surfaces six previously-hidden `Configuration` fields (Load Previous Session,
+Filter Include Previous Sessions, Auto-Tell-Tabs History Preload, Compact Density, Prettier
+Timestamps, built-in theme picker) without introducing any new fields.
+
+Window default size shrinks from 900×560 to 720×480 (MinimumSize 600×400) and Step 1 wraps the fox
+banner in a folded TreeNode after smoke feedback. Existing v1.5.1 users see the new wizard once on
+first v1.5.2 boot via a new `WizardLastShownVersion` config marker.
+
+Under the hood: `WizardStateSmokeStep` joins the `/xlperf` lineup, the Build Suite gains twelve
+pure-helper xUnit Facts pinning all four privacy profile sets and the new Roleplay retention
+overrides. Migration v17 stays — `Configuration` only grows one optional string field.

 ---
Author	SHA1	Message	Date
JonKazama-Hellion	a46d89c197	Merge branch 'feature/v1.5.4' Security / scan (push) Successful in 20s Details Build / Build (Release) (push) Successful in 27s Details Forge Announce / Post changelog to Hellion Forge (push) Successful in 6s Details Release / Build and attach release ZIP (push) Successful in 36s Details	2026-05-20 16:42:39 +02:00
JonKazama-Hellion	57b6ead003	release(v1.5.4): manifest bump and forge post Bumps csproj, yaml, repo.json, CHANGELOG, ROADMAP and README in lock-step to 1.5.4. Forge-post DE-body added with the Polish & Motion versionsnatur. Slim-rule applied to the yaml and repo.json changelog blocks (keeps v1.5.4 + v1.5.3 + v1.5.2 + v1.5.1, drops v1.5.0). A csharpier reflow of two v1.5.4 source files (ChatLogWindow, HellionStyle) is folded in. preflight.sh blocks A-F all green.	2026-05-20 16:32:42 +02:00
JonKazama-Hellion	a42cc2a97e	test(selftest): pin v1.5.4 crossfade and quick-picker contracts ThemeCrossfadeSelfTestStep walks Switch -> crossfade-observed -> mid-crossfade-switch -> crossfade-end -> restore using TryGetActiveCrossfade, returns Waiting frame-by-frame and Pass after the restore concludes. The mid-switch phase fires a second Switch within ~100ms of the first observed crossfade and asserts the lerped value is neither identity-from nor identity-to, exercising the ArmCrossfade mid-flight-origin override. QuickPickerSelfTestStep verifies the three new resource strings, the built-in theme floor (>=10), and Config.Tabs non-empty.	2026-05-20 16:21:29 +02:00
JonKazama-Hellion	96ff4ddfd8	feat(ui): lerp sidebar-icon and card-mode-border hover alphas Sidebar icons ease from 40% to 100% alpha on hover-in via FrameLerp plus ApplyAlpha. Card-mode borders aggregate row-hover per tab and lift the border alpha by up to ~+0x70 across every row in that tab. borderColorAbgr moves into the loop so the per-iteration boost can apply. ReduceMotion snaps both paths instantly. Card-hover detection uses IsMouseHoveringRect over the row bounds -- IsItemHovered would only see the 2px spacer dummy below each row.	2026-05-20 14:42:21 +02:00
JonKazama-Hellion	0bfe3a62cb	feat: add FrameLerp helper and per-tab hover-alpha fields FrameLerp.Smooth is the framerate-independent smoothing path -- a Umbra-style v += (target - v) * factor with the factor clamped to 1 so a stalled frame snaps cleanly instead of overshooting. Tab gets two NonSerialized fields (_hoverAlpha, _cardHoverAlpha) that the v1.5.4 render loops drive.	2026-05-20 13:26:16 +02:00
JonKazama-Hellion	01a7f9b4ec	feat(ui): add header quick-picker for themes and tabs Palette button left of the cog opens a two-section popup. The themes section enumerates AllBuiltIns + AllCustom; the tabs section enumerates Config.Tabs. The active entry gets a leading check-glyph, inactive rows a same-width blank so labels stay aligned. Click selects without closing the popup (DontClosePopups). Theme click triggers the PM-1 crossfade via ThemeRegistry.Switch; tab click routes through ChangeTab so LastActivityTime stays consistent with the sidebar and top-bar click paths. The header input-width reservation now counts the new button plus the per-button SameLine spacing -- the old formula dropped the spacing term and overflowed the row once a third button appeared.	2026-05-20 12:48:31 +02:00
JonKazama-Hellion	0237602ab7	feat(util): add ColourUtil.ApplyAlpha for hover-lerp modulation Alpha-only modulator for ABGR colors -- RGB stays intact, factor clamped to [0, 1]. Used by the v1.5.4 PM-3 hover-lerp path.	2026-05-20 11:20:48 +02:00
JonKazama-Hellion	a600f014eb	i18n: add quick-picker strings and reduce-motion settings toggle Five new keys across the EN source plus 24 locale variants (DE plus 23 AI-assisted, each carrying the pending-review marker): the header quick-picker tooltip and two section headers, plus name and description for a new ReduceMotion checkbox. ReduceMotion was a config field with no UI -- the checkbox lands in the Theme & Layout tab's window-style section. Designer.cs hand-edited as a v1.5.4 block matching the v1.4.8 convention.	2026-05-20 11:07:45 +02:00
JonKazama-Hellion	a35067f80a	feat(ui): wire ThemeRegistry crossfade into PushGlobal Switch picks a lerped AbgrCache during the 300ms crossfade window (ReduceMotion bypass keeps the snap path). Plugin-load init path switches to SwitchSilent so opening the plugin no longer fades from the default theme. WindowBg/ChildBg RGBA path stays bound to the user's per-window opacity override and never fades. PushGlobal takes the ThemeRegistry as a parameter -- it is an instance member on Plugin, not static, so the single Plugin.Draw call-site threads it through alongside the active theme.	2026-05-20 10:36:33 +02:00
JonKazama-Hellion	74b07519f5	feat(themes): arm crossfade state in ThemeRegistry.Switch Three new private fields plus TryGetActiveCrossfade entry-point, plus SwitchSilent variant for the plugin-load init path. ArmCrossfade captures a value-copy of the active AbgrCache and stamps TickCount64; mid-crossfade Switch composes the current lerped state as the next fade origin so back-to-back theme switches stay smooth. Same-slug Switch is a no-op (no identity-crossfade).	2026-05-20 09:26:51 +02:00
JonKazama-Hellion	8dade8c4b2	feat(themes): add ThemeAbgrCacheLerp pure-helper for crossfade Per-slot ABGR byte-lerp between two cache value-records, stack-allocated output, t clamped. Pattern anchor: imgui.cpp ImAlphaBlendColors.	2026-05-20 08:57:33 +02:00
JonKazama-Hellion	35e8d3a7fe	fix(font): bundled font now actually renders, ship Inter Light, +CJK fallback Security / scan (push) Successful in 19s Details Build / Build (Release) (push) Successful in 29s Details Forge Announce / Post changelog to Hellion Forge (push) Successful in 5s Details Release / Build and attach release ZIP (push) Successful in 49s Details 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.	2026-05-19 17:28:48 +02:00
JonKazama-Hellion	38586db9d8	fix(l10n): em-dash sweep across EN source and translations, backfill Crowdin gap - HellionStrings.resx: 10 in-prose em-dashes -> period/colon per style guide - 18 HellionStrings.<lang>.resx: 114 mechanical em-dash edits via heuristic (period before capital, colon otherwise). Skipped: fr (already clean), zh-Hans/zh-Hant (already clean), ru/uk (em-dash is orthographic norm) - HellionStrings.de.resx: fix substantive-heuristic miss in Wizard_Cancel_Label - Language.de.resx: add Hellion Forge maintainer header (native-maintained) - Backfill the 4 post-Crowdin keys (Options_ColorSelectedInputChannelButton_, Options_HideInNewGamePlusMenu_) into 13 legacy Crowdin locales with per-key AI-assisted comment marker. All 23 Language.*.resx now at 456 keys.	2026-05-19 13:52:18 +02:00
JonKazama-Hellion	c357873604	feat(l10n): add HellionStrings bundle (EN + 22 variants) and Language siblings — WIP v1.5.3 Security / scan (push) Successful in 28s Details Build / Build (Release) (push) Successful in 30s Details Split fork-added keys into a dedicated HellionStrings resource bundle separate from the Language.*.resx Chat-2 Crowdin heritage. - Add HellionStrings.resx (EN source, 328 keys) and HellionStrings.Designer.cs - Add 22 HellionStrings.<code>.resx variants: ca, cs, da, de, es, fi, fr, hu, it, ja, ko, nb, nl, pl, pt-BR, pt-PT, ro, ru, sv, tr, uk, zh-Hans, zh-Hant - Add matching Language.<code>.resx siblings for the new locales with the Hellion Forge maintainer header - FR pass: align labels with the rest of the UI (Confidentialité, Visualiseur, Violet indigo)	2026-05-19 09:32:45 +02:00
JonKazama-Hellion	67bec11f10	Merge branch 'feature/v1.5.2' Security / scan (push) Successful in 18s Details Build / Build (Release) (push) Successful in 28s Details Forge Announce / Post changelog to Hellion Forge (push) Successful in 6s Details Release / Build and attach release ZIP (push) Successful in 40s Details	2026-05-18 23:47:59 +02:00
JonKazama-Hellion	35efdd4628	style(wizard): reflow FirstRunWizard and WizardStateSmokeStep to csharpier Preflight Block E (`dotnet csharpier check`) flagged two reflows in the v1.5.2 code: the ForgeBronzeDim Vector4 constant needed multi-line form, and a handful of switch arms / long Plugin.Config chains in WizardStateSmokeStep needed line-breaks at csharpier's print-width. Pure formatting — zero functional change. Block D build stays clean, Block E now passes.	2026-05-18 23:46:00 +02:00
JonKazama-Hellion	271a6ae650	docs(forge): add v1.5.2 forge announcement post body Bilingual layout: DE in this file, EN extracted by forge-announce.yml from HellionChat.yaml changelog block. Body covers the four-step wizard rewrite, the new Roleplay profile, the surfaced power settings, the staged-commit + test-hint pattern, the WizardLastShownVersion re-show-once mechanism for existing users and the under-the-hood test additions. Subtitle 54 chars, versionsnatur 8 chars, embed sum (forge body + en-yaml + footer) 4158 chars — all under the workflow caps (60 / 40 / 5500).	2026-05-18 23:42:44 +02:00
JonKazama-Hellion	003bd5c695	docs(changelog): polish v1.5.2 prose hygiene Fixes two minor copy-paste artefacts in the v1.5.2 CHANGELOG block: the duplicate trailing "EUPL-1.2." right after the Based-on footer, and a stray German "Optik" tab name in the power-settings list (the settings tab is "Appearance" in EN, the German label only appears in the localised UI). Yaml / repo.json / ROADMAP / README already used the right wording.	2026-05-18 23:36:13 +02:00
JonKazama-Hellion	e1f84a9b10	chore(release): v1.5.2 manifest bump Bumps csproj Version, repo.json AssemblyVersion/TestingAssemblyVersion plus the three DownloadLink* URLs, yaml + repo.json changelog blocks (slim-rule: v1.5.2 + v1.5.1 + v1.5.0 + v1.4.10 retained, v1.4.9 trimmed to the Full history footer link), docs CHANGELOG long-form block, ROADMAP v1.5.2 marked complete and v1.5.3 set as next cycle (FR localisation with Hezcal native-speaker review), README status strings plus moved pre-v1.5.2 history. Changelog includes the in-cycle UI shrink + Fox-Banner-TreeNode smoke fix and the WizardLastShownVersion re-show-once mechanism for existing users.	2026-05-18 23:29:56 +02:00
JonKazama-Hellion	9745abea0c	feat(wizard): re-surface first-run wizard once for existing v1.5.2 users Bestehende User haben FirstRunCompleted=true vom alten Single-Page Wizard und würden den neuen Multi-Step-Flow nie zu sehen bekommen. Neues Config-Feld WizardLastShownVersion (Default leer) trägt die Version, deren Wizard zuletzt gezeigt wurde. Plugin.LoadAsync vergleicht gegen die Konstante WizardReshowVersion ("1.5.2") und setzt FirstRunCompleted einmalig zurück, wenn die Werte abweichen. SaveConfig sofort danach, damit ein Pre-Finish-Crash die Re-Show nicht endlos wiederholt. Künftige Cycles bumpen die Konstante nur wenn der Wizard wirklich umstrukturiert wird.	2026-05-18 23:18:19 +02:00
JonKazama-Hellion	1e418ab86f	fix(ui): shrink wizard window and fold the Fox banner by default Smoke feedback v1.5.2 R1: the 900x560 default size dominated the screen and the centred MonoFont fox silhouette filled the welcome step. Default size drops to 720x480, MinimumSize to 600x400, so the wizard fits comfortably on a sub-monitor and still leaves the power-settings step readable when shrunk. Step 1 wraps the banner in a folded TreeNode (label "Hellion Forge", same anchor pattern the v1.5.1 wizard used) so the onboarding copy stays the primary focus and users opt into the silhouette explicitly.	2026-05-18 23:10:53 +02:00
JonKazama-Hellion	1c820b7f53	test(selftest): register WizardStateSmokeStep for v1.5.2 wizard flow Variant 1 walks the FirstRunWizard state machine through Step 1 → 4 and commits with no pending values to verify the no-op write-back path. Variant 2 picks Roleplay on Step 2, skips Step 3, commits, and asserts LoadPreviousSession / FilterIncludePreviousSessions stayed on their pre-test value — pinning the null-semantics from Spec Z.176. ApplyRoleplay would overwrite six privacy / retention fields, so the step snapshots them before Variant 2 and CleanUp() restores them, keeping the self-test idempotent across /xlperf runs. Catches state-machine throws and CommitPending NREs that would otherwise surface as a hard plugin crash during Finish ✓ clicks. Runs alongside the existing three FontManager / ThemeSwitch self-test steps.	2026-05-18 22:03:50 +02:00
JonKazama-Hellion	2cc260170e	feat(ui): rewrite FirstRunWizard as four-step staged-commit flow Multi-step navigation (Welcome → Privacy → Power Settings → Done) with a nested WizardState holding nullable Pending* fields. Profile picker becomes a 2x2 grid covering all four privacy profiles (PrivacyFirst, Casual ★ recommended, Roleplay new, FullHistory). Power-settings step surfaces six previously-hidden Configuration fields (LoadPreviousSession, FilterIncludePreviousSessions, AutoTellTabsHistoryPreload, UseCompactDensity, PrettierTimestamps, Theme) without introducing new ones. ApplyRoleplay mirrors the existing Apply* methods, CommitPending writes only the non-null fields back so skipping a step preserves existing config. OnClose docstring updated to reflect the actual code path (both Decide-Later and Finish set FirstRunCompleted = true, the wizard does not reopen).	2026-05-18 21:15:27 +02:00
JonKazama-Hellion	de86084dbc	feat(resources): add multi-step wizard strings for v1.5.2 (EN + DE) Thirty-two new bilingual resource keys covering all four wizard steps: titles, section headings, control labels, navigation, the new Roleplay profile, the staged-summary template strings, the 'Decide later' multi-step skip label plus its dedicated tooltip. Existing Wizard_Cancel_Label and Wizard_Cancel_Tooltip stay untouched for legacy reopen paths.	2026-05-18 20:26:22 +02:00
JonKazama-Hellion	f56b968768	feat(privacy): add Roleplay profile defaults to PrivacyDefaults Adds RoleplayWhitelist (PrivacyFirst + Say + both emote types) and RoleplayRetentionOverrides (Say 30d, emotes 90d). Shout/Yell and Novice Network stay out — public-distance noise from strangers is not story content. Whitelist + overrides are IReadOnlySet / IReadOnlyDictionary with pure-helper type footprint, so the Build Suite can pin them without touching Dalamud.	2026-05-18 19:02:54 +02:00