acdream/tests/AcDream.App.Tests/Settings/RuntimeSettingsControllerTests.cs
Erik a819687cf0 feat(chat): Campaign CH slice CH6c — window opacity + transparency setting
Retail's ChatInterface::SetOpacity (0x004F3120) fades the WHOLE composited
window surface with one alpha; UiRenderContext.ApplyAlpha already gated
DrawSprite/DrawRect/DrawFill (since 1da697ec, pre-CH6) but DrawStringDat and
DrawString still passed applyAlpha:false, so text stayed sharp over a
translucent window. Both now route through the same chokepoint.

RetailWindowOpacityController (new) subscribes to a new
RetailWindowManager.WindowRegistered event and drives every registered
window's live Opacity from keyboard-focus state, applied to EVERY window
(chat, floaties, vitals, toolbar, ...) rather than retail's ChatInterface-only
scope — register row AP-190, retiring the stale AP-40 "fixed 0.75, no focus
transition" row in the same commit.

Verified retail's shipped opacity defaults from the decomp (constructor
literals, no cdb needed): the base ChatInterface ctor sets
DefaultOpacity=0.5/ActiveOpacity=1.0, kept unmodified by the four floating
windows; gmMainChatUI's own ctor overrides the main window to 1.0/1.0
(always fully opaque). acdream ships one shared global default (0.5/1.0)
rather than replicating the per-class override — also AP-190. The linking
invariant (raising default above active drags active UP; lowering active
below default drags default DOWN — never a clamp) is ported verbatim as
ChatOpacityLink in AcDream.UI.Abstractions, shared by the live controller
and the new Settings -> Chat tab's two linked opacity sliders.

Persistence: ChatSettings.DefaultOpacity/ActiveOpacity round-trip through
SettingsStore; Save pushes both through IRuntimeSettingsTargets.SetChatOpacity
into the live controller, no restart required.

Rider (CH6a/b re-review): strengthened the grip-media regression guard past
a bare SpriteFile != 0 check — ChatLayoutConformanceTests now drives each
live grip through a real UiRenderContext/TextRenderer (backed by the
in-memory RecordingGpuDevice test double) and asserts the draw call chain
actually queued sprite geometry, via a new TextRenderer.DebugSpriteSegments
test-only accessor.

Full Release suite 12,459 passed / 4 skipped / 0 failed (baseline
12,420/4/0). No subagents, no client launches (session hard constraints);
pending the next connected user gate for visual confirmation.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-10 14:00:55 +02:00

1476 lines
52 KiB
C#

using AcDream.App.Diagnostics;
using AcDream.App.Net;
using AcDream.App.Rendering;
using AcDream.App.Settings;
using AcDream.Core.Net.Messages;
using AcDream.UI.Abstractions;
using AcDream.UI.Abstractions.Input;
using AcDream.UI.Abstractions.Panels.Settings;
using AcDream.UI.Abstractions.Settings;
using Silk.NET.Input;
namespace AcDream.App.Tests.Settings;
public sealed class RuntimeSettingsControllerTests
{
[Fact]
public void ConstructionLoadsEachBagOnceAndPublishesOneStartupSnapshot()
{
var storage = new FakeStorage
{
DisplayValue = DisplaySettings.Default with
{
VSync = false,
Quality = QualityPreset.Ultra,
},
GameplayValue = GameplaySettings.Default with
{
AutoTarget = true,
AutoRepeatAttack = true,
ViewCombatTarget = true,
},
};
var resolved = new QualitySettings(7, 18, 8, 16, true, 9);
int resolveCount = 0;
var controller = new RuntimeSettingsController(
storage,
preset =>
{
resolveCount++;
Assert.Equal(QualityPreset.Ultra, preset);
return resolved;
},
static _ => { });
Assert.Equal(1, storage.DisplayLoads);
Assert.Equal(1, storage.AudioLoads);
Assert.Equal(1, storage.GameplayLoads);
Assert.Equal(1, storage.ChatLoads);
Assert.Equal(1, storage.CharacterLoads);
Assert.Equal(1, resolveCount);
Assert.Equal("default", storage.LastLoadedCharacter);
Assert.Same(storage.DisplayValue, controller.Startup.Display);
Assert.Same(storage.AudioValue, controller.Startup.Audio);
Assert.Same(storage.GameplayValue, controller.Startup.Gameplay);
Assert.Same(storage.ChatValue, controller.Startup.Chat);
Assert.Same(storage.DefaultCharacterValue, controller.Startup.Character);
Assert.Equal(resolved, controller.Startup.Quality);
Assert.Equal(resolved, controller.ResolvedQuality);
Assert.True(controller.AutoTarget);
Assert.True(controller.AutoRepeatAttack);
Assert.True(controller.ViewCombatTarget);
Assert.Equal("default", controller.ActiveToonKey);
}
[Fact]
public void StartupApplyIsOrderedExactlyOnceAndRuntimeBindingDoesNotReplay()
{
var events = new List<string>();
var controller = CreateController(events: events);
var startup = new FakeStartupTarget(events);
controller.ApplyStartup(startup);
Assert.Equal(["startup-display", "startup-audio"], events);
Assert.Throws<InvalidOperationException>(() => controller.ApplyStartup(startup));
events.Clear();
var runtime = new FakeRuntimeTargets(events);
controller.BindRuntimeTargets(runtime);
Assert.Empty(events);
Assert.Throws<InvalidOperationException>(() =>
controller.BindRuntimeTargets(new FakeRuntimeTargets(events)));
}
[Fact]
public void ViewModelBindingReleasesOnlyItsExpectedInstance()
{
var controller = CreateController();
using InputDispatcher dispatcher = CreateDispatcher();
RuntimeSettingsViewModelBinding first = controller.CreateViewModelBinding(
new KeyBindings(),
dispatcher,
static _ => { });
first.Dispose();
RuntimeSettingsViewModelBinding second = controller.CreateViewModelBinding(
new KeyBindings(),
dispatcher,
static _ => { });
first.Dispose();
Assert.Throws<InvalidOperationException>(() =>
controller.CreateViewModelBinding(
new KeyBindings(),
dispatcher,
static _ => { }));
second.Dispose();
}
[Fact]
public void StartupRetryResumesAfterLastSuccessfulStage()
{
var displayEvents = new List<string>();
var displayController = CreateController();
var displayTarget = new FakeStartupTarget(displayEvents)
{
RemainingDisplayFailures = 1,
};
Assert.Throws<InvalidOperationException>(() =>
displayController.ApplyStartup(displayTarget));
displayController.ApplyStartup(displayTarget);
Assert.Equal(
["startup-display", "startup-display", "startup-audio"],
displayEvents);
var audioEvents = new List<string>();
var audioController = CreateController();
var audioTarget = new FakeStartupTarget(audioEvents)
{
RemainingAudioFailures = 1,
};
Assert.Throws<InvalidOperationException>(() =>
audioController.ApplyStartup(audioTarget));
audioController.ApplyStartup(audioTarget);
Assert.Equal(
["startup-display", "startup-audio", "startup-audio"],
audioEvents);
}
[Fact]
public void ConcreteStartupTargetAppliesPacingThenWindowThenPersistedFov()
{
using var profiler = new FrameProfiler();
using var pacing = new DisplayFramePacingController(
uncappedRendering: false,
profiler,
new FramePacingController(new FakeClock(), new NullWaiter()));
var surface = new FakePacingSurface
{
VSync = true,
ActiveMonitorRefreshHz = 144,
};
pacing.InitializeStartup(requestedVSync: true);
pacing.BindSurface(surface);
var cameras = new CameraController(new OrbitCamera(), new FlyCamera());
float originalFov = cameras.Orbit.FovY;
var displayWindow = new InspectingDisplayWindowTarget(display =>
{
Assert.False(pacing.RequestedVSync);
Assert.Equal(originalFov, cameras.Orbit.FovY);
Assert.Equal("1600x900", display.Resolution);
});
var target = new RuntimeSettingsStartupTargets(
displayWindow,
pacing,
cameras,
audio: null);
target.ApplyDisplay(DisplaySettings.Default with
{
Resolution = "1600x900",
VSync = false,
FieldOfView = 83f,
});
Assert.Equal(1, displayWindow.ApplyCount);
Assert.Equal(1, surface.RefreshReadCount);
Assert.Equal(new FramePacingPolicy(false, 144d), pacing.Policy);
Assert.Equal(83f * (MathF.PI / 180f), cameras.Orbit.FovY, precision: 5);
Assert.Equal(83f * (MathF.PI / 180f), cameras.Fly.FovY, precision: 5);
}
[Fact]
public void ConcreteRuntimeTargetAppliesEveryQualityDimensionInOrder()
{
var events = new List<string>();
var qualityTarget = new RecordingQualityApplicationTarget(events);
var displayTarget = new InspectingDisplayWindowTarget(
_ => events.Add("display"));
var uiTarget = new RecordingUiLockTarget(events);
var target = new RuntimeSettingsTargets(
displayTarget,
qualityTarget,
uiTarget,
NullCommandBus.Instance,
static _ => { });
var quality = new QualitySettings(6, 17, 4, 12, true, 7);
target.ApplyQuality(quality);
Assert.Equal(
[
"a2c:True",
"aniso:12",
"range:6:17",
"stream:6:17",
"budget:7",
],
events);
Assert.Equal(quality, qualityTarget.Observed);
}
[Fact]
public void ConcreteRuntimeQualityTargetStopsAtTheThrowingStep()
{
string[] allSteps =
[
"a2c",
"aniso",
"range",
"stream",
"budget",
];
for (int failureIndex = 0; failureIndex < allSteps.Length; failureIndex++)
{
var events = new List<string>();
var target = new RuntimeSettingsTargets(
new InspectingDisplayWindowTarget(static _ => { }),
new FailingQualityApplicationTarget(events, failureIndex),
new RecordingUiLockTarget(events),
NullCommandBus.Instance,
static _ => { });
Assert.Throws<InvalidOperationException>(() =>
target.ApplyQuality(QualitySettings.From(QualityPreset.High)));
Assert.Equal(allSteps[..(failureIndex + 1)], events);
}
}
[Fact]
public void ConcreteRuntimeTargetPublishesSetSingleCharacterOptionOntoTheBus()
{
// CH3 review S5(b): SaveChatPublishesSetSingleCharacterOption... above
// only proves RuntimeSettingsController calls the IRuntimeSettingsTargets
// INTERFACE (via the FakeRuntimeTargets test double) — nothing exercised
// the CONCRETE RuntimeSettingsTargets.SetSingleCharacterOption, which is
// the code that actually reaches the wire via ICommandBus.Publish. A
// silent unwiring there (wrong record, wrong bus, dropped call) would
// pass every test that only goes through the fake.
var bus = new CaptureCommandBus();
var target = new RuntimeSettingsTargets(
new InspectingDisplayWindowTarget(static _ => { }),
new RecordingQualityApplicationTarget([]),
new RecordingUiLockTarget([]),
bus,
static _ => { });
target.SetSingleCharacterOption(
(uint)CharacterOptionId.ListenToRoleplayChat, value: false);
var cmd = Assert.IsType<SetSingleCharacterOptionRuntimeCmd>(
Assert.Single(bus.Published));
Assert.Equal((uint)CharacterOptionId.ListenToRoleplayChat, cmd.OptionId);
Assert.False(cmd.Value);
}
[Fact]
public void SettingsViewModelSavePreservesSectionAndTargetOrder()
{
var events = new List<string>();
var storage = new FakeStorage(events);
var resolved = new QualitySettings(5, 15, 4, 16, true, 6);
var controller = new RuntimeSettingsController(
storage,
_ => resolved,
static _ => { });
storage.ClearEvents();
var targets = new FakeRuntimeTargets(events);
controller.BindRuntimeTargets(targets);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
_ => events.Add("save-bindings"));
viewModel.SetDisplay(viewModel.DisplayDraft with
{
Resolution = "1920x1080",
Quality = QualityPreset.Ultra,
});
viewModel.SetAudio(viewModel.AudioDraft with { Master = 0.25f });
viewModel.SetGameplay(viewModel.GameplayDraft with { LockUI = true });
viewModel.SetChat(viewModel.ChatDraft with { ShowTimestamps = true });
viewModel.SetCharacter(viewModel.CharacterDraft with { AutoAttack = true });
viewModel.Save();
Assert.Equal(
[
"save-bindings",
"save-display",
"target-display",
"target-quality",
"save-audio",
"save-gameplay",
"target-ui-lock:True",
"save-chat",
"target-chat-opacity:0.5:1",
"save-character:default",
],
events);
Assert.Equal("1920x1080", controller.Display.Resolution);
Assert.Equal(0.25f, controller.Audio.Master);
Assert.True(controller.Gameplay.LockUI);
Assert.True(controller.Chat.ShowTimestamps);
Assert.True(controller.Character.AutoAttack);
Assert.Equal(resolved, controller.ResolvedQuality);
}
[Fact]
public void SaveChatPublishesSetSingleCharacterOptionOnlyForChangedBits()
{
// CH3 (2026-08-09): SaveChat must publish SetSingleCharacterOption
// (0x0005) for exactly the Hear*Chat bits that actually changed —
// touching one checkbox must not resend the other four.
var storage = new FakeStorage();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
static _ => { });
var targets = new FakeRuntimeTargets([]);
controller.BindRuntimeTargets(targets);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
// N4 (CH3 Opus review): ChatSettings.Default now matches ACE's real
// CharacterOptions2.Default — Roleplay/Society start FALSE (only
// General/Trade/LFG start true). Flip Roleplay ON first so the
// second edit below can flip it back off.
Assert.False(viewModel.ChatDraft.HearRoleplayChat);
viewModel.SetChat(viewModel.ChatDraft with { HearRoleplayChat = true });
viewModel.Save();
Assert.Equal(
[((uint)CharacterOptionId.ListenToRoleplayChat, true)],
targets.SingleOptionCalls);
targets.SingleOptionCalls.Clear();
viewModel.SetChat(viewModel.ChatDraft with
{
HearRoleplayChat = false,
HearSocietyChat = true,
});
viewModel.Save();
Assert.Equal(
[
((uint)CharacterOptionId.ListenToRoleplayChat, false),
((uint)CharacterOptionId.ListenToSocietyChat, true),
],
targets.SingleOptionCalls);
}
[Fact]
public void SaveChatWithNoHearOptionChangePublishesNothing()
{
var controller = CreateController();
var targets = new FakeRuntimeTargets([]);
controller.BindRuntimeTargets(targets);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
// Touch a Chat field that is NOT a Hear*Chat membership bit.
viewModel.SetChat(viewModel.ChatDraft with { ShowTimestamps = false });
viewModel.Save();
Assert.Empty(targets.SingleOptionCalls);
}
[Fact]
public void SaveChat_PushesOpacityToRuntimeTargets_LiveApply_NoRestart()
{
// Campaign CH slice CH6c: unlike the Hear* options (local-only, no
// wire), opacity is ALWAYS pushed on Save (not diffed) so the linking
// invariant self-heals; the point of this test is that clicking Save
// is enough — no restart, no separate "apply" step.
var controller = CreateController();
var targets = new FakeRuntimeTargets([]);
controller.BindRuntimeTargets(targets);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
viewModel.SetChat(viewModel.ChatDraft with
{
DefaultOpacity = 0.3f,
ActiveOpacity = 0.6f,
});
viewModel.Save();
Assert.Equal([(0.3f, 0.6f)], targets.ChatOpacityCalls);
Assert.Equal(0.3f, controller.Chat.DefaultOpacity);
Assert.Equal(0.6f, controller.Chat.ActiveOpacity);
}
[Fact]
public void ConcreteRuntimeTargetForwardsChatOpacityToTheLiveController()
{
// Mirrors ConcreteRuntimeTargetPublishesSetSingleCharacterOptionOntoTheBus
// below: proves the CONCRETE RuntimeSettingsTargets.SetChatOpacity wiring,
// not just the IRuntimeSettingsTargets interface via the fake.
var recording = new RecordingChatOpacityTarget();
var target = new RuntimeSettingsTargets(
new InspectingDisplayWindowTarget(static _ => { }),
new RecordingQualityApplicationTarget([]),
new RecordingUiLockTarget([]),
NullCommandBus.Instance,
log: static _ => { },
chatOpacity: recording);
target.SetChatOpacity(0.25f, 0.75f);
Assert.Equal((0.25f, 0.75f), Assert.Single(recording.Calls));
}
private sealed class RecordingChatOpacityTarget : IRuntimeChatOpacityTarget
{
public List<(float DefaultOpacity, float ActiveOpacity)> Calls { get; } = [];
public void Apply(float defaultOpacity, float activeOpacity) =>
Calls.Add((defaultOpacity, activeOpacity));
}
[Fact]
public void SyncChatFromServerOptionsReseedsPersistedAndDraft()
{
// Research doc §5.2: ACE's CharacterOptions2.Default omits
// HearRoleplayChat/HearSocietyChat. N4 (CH3 Opus review) aligned
// ChatSettings.Default to that same stance, so this test now seeds
// storage with an explicitly stale PERSISTED value (both on — e.g.
// a save from before N4, or a user who had enabled them) to prove
// the server sync corrects local state to the server's truth,
// rather than merely observing the two already agree.
var storage = new FakeStorage
{
ChatValue = ChatSettings.Default with
{
HearRoleplayChat = true,
HearSocietyChat = true,
},
};
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
static _ => { });
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
Assert.True(controller.Chat.HearRoleplayChat);
Assert.True(viewModel.ChatDraft.HearRoleplayChat);
controller.SyncChatFromServerOptions(0x00948700u); // ACE's real default
Assert.True(controller.Chat.HearGeneralChat);
Assert.True(controller.Chat.HearTradeChat);
Assert.True(controller.Chat.HearLFGChat);
Assert.False(controller.Chat.HearRoleplayChat);
Assert.False(controller.Chat.HearSocietyChat);
Assert.False(viewModel.ChatDraft.HearRoleplayChat);
Assert.False(viewModel.ChatDraft.HearSocietyChat);
Assert.Same(controller.Chat, storage.ChatValue);
}
[Fact]
public void SyncChatFromServerOptionsPreservesUnsavedUnrelatedDraftEdits()
{
var controller = CreateController();
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
viewModel.SetChat(viewModel.ChatDraft with { FontSize = 18f });
controller.SyncChatFromServerOptions(0x00948700u);
Assert.Equal(18f, viewModel.ChatDraft.FontSize);
Assert.False(viewModel.ChatDraft.HearRoleplayChat);
}
[Fact]
public void SyncChatFromServerOptionsIsANoOpWhenUnchanged()
{
var storage = new FakeStorage();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
static _ => { });
storage.ClearEvents();
// N4 (CH3 Opus review): ChatSettings.Default now matches ACE's real
// CharacterOptions2.Default exactly — General/Trade/LFG on,
// Roleplay/Society off. Syncing with that SAME bit pattern (any
// other bits are irrelevant, the sync only masks these five) must
// be a true no-op.
const uint aceDefaultHearBits =
(uint)PlayerDescriptionParser.CharacterOptions2.HearGeneralChat
| (uint)PlayerDescriptionParser.CharacterOptions2.HearTradeChat
| (uint)PlayerDescriptionParser.CharacterOptions2.HearLFGChat;
controller.SyncChatFromServerOptions(aceDefaultHearBits);
Assert.Equal(0, storage.ChatSaves);
}
[Fact]
public void DraftPreviewAndExternalCommandsShareCanonicalState()
{
var events = new List<string>();
var storage = new FakeStorage(events);
var controller = CreateController(storage, events: events);
storage.ClearEvents();
var targets = new FakeRuntimeTargets(events);
controller.BindRuntimeTargets(targets);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
viewModel.SetDisplay(viewModel.DisplayDraft with
{
FieldOfView = 91f,
ParticleRange = ParticleRange.Retail,
});
viewModel.SetAudio(viewModel.AudioDraft with { Sfx = 0.33f });
viewModel.SetGameplay(viewModel.GameplayDraft with { AutoTarget = true });
Assert.True(controller.HasDraftPreview);
Assert.Equal(91f, controller.DisplayPreview.FieldOfView);
Assert.Equal(ParticleRange.Retail, controller.DisplayPreview.ParticleRange);
Assert.Equal(0.33f, controller.AudioPreview.Sfx);
controller.ToggleFrameRate();
controller.SetUiLocked(true);
controller.SetAcceptLootPermits(true);
Assert.True(controller.Display.ShowFps);
Assert.True(controller.DisplayPreview.ShowFps);
Assert.Equal(91f, controller.DisplayPreview.FieldOfView);
Assert.True(controller.Gameplay.LockUI);
Assert.True(controller.Gameplay.AcceptLootPermits);
Assert.True(viewModel.GameplayDraft.AutoTarget);
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.True(viewModel.GameplayDraft.AcceptLootPermits);
Assert.Contains("target-ui-lock:True", events);
Assert.Equal(2, storage.GameplaySaves);
Assert.Equal(1, storage.DisplaySaves);
}
[Fact]
public void DraftCancelRestoresPreviewAndCombatTogglePreservesUnrelatedDrafts()
{
var storage = new FakeStorage();
var controller = CreateController(storage);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
viewModel.SetDisplay(viewModel.DisplayDraft with { FieldOfView = 99f });
viewModel.SetGameplay(viewModel.GameplayDraft with
{
ShowTooltips = false,
CoordinatesOnRadar = false,
});
controller.SetCombatGameplay(controller.Gameplay with { AutoTarget = false });
controller.SetUiLocked(true);
controller.SetAcceptLootPermits(true);
Assert.False(controller.Gameplay.AutoTarget);
Assert.False(viewModel.GameplayDraft.AutoTarget);
Assert.False(viewModel.GameplayDraft.ShowTooltips);
Assert.False(viewModel.GameplayDraft.CoordinatesOnRadar);
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.True(viewModel.GameplayDraft.AcceptLootPermits);
Assert.Equal(99f, controller.DisplayPreview.FieldOfView);
viewModel.Cancel();
Assert.Equal(controller.Display.FieldOfView, controller.DisplayPreview.FieldOfView);
Assert.Equal(controller.Gameplay.ShowTooltips, viewModel.GameplayDraft.ShowTooltips);
Assert.Equal(
controller.Gameplay.CoordinatesOnRadar,
viewModel.GameplayDraft.CoordinatesOnRadar);
Assert.False(viewModel.GameplayDraft.AutoTarget);
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.True(viewModel.GameplayDraft.AcceptLootPermits);
viewModel.SetGameplay(viewModel.GameplayDraft with { ShowHelm = false });
viewModel.Save();
Assert.False(storage.GameplayValue.AutoTarget);
Assert.True(storage.GameplayValue.LockUI);
Assert.True(storage.GameplayValue.AcceptLootPermits);
Assert.False(storage.GameplayValue.ShowHelm);
}
[Fact]
public void FailedExternalGameplayPersistenceDoesNotPromoteViewModelBaseline()
{
var storage = new FakeStorage { ThrowOnGameplaySave = true };
var logs = new List<string>();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
logs.Add);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
controller.SetUiLocked(true);
controller.SetCombatGameplay(controller.Gameplay with { AutoTarget = false });
Assert.Throws<IOException>(() => controller.SetAcceptLootPermits(true));
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.False(viewModel.GameplayDraft.AutoTarget);
Assert.True(viewModel.GameplayDraft.AcceptLootPermits);
viewModel.Cancel();
Assert.Equal(GameplaySettings.Default.LockUI, viewModel.GameplayDraft.LockUI);
Assert.Equal(
GameplaySettings.Default.AutoTarget,
viewModel.GameplayDraft.AutoTarget);
Assert.Equal(
GameplaySettings.Default.AcceptLootPermits,
viewModel.GameplayDraft.AcceptLootPermits);
Assert.Contains(logs, line =>
line.Contains("radar lock save failed", StringComparison.Ordinal));
Assert.Contains(logs, line =>
line.Contains("combat option save failed", StringComparison.Ordinal));
}
[Fact]
public void CharacterContextLoadsWithoutViewModelAndSynchronizesWhenBound()
{
var storage = new FakeStorage();
storage.Characters["Alice"] = CharacterSettings.Default with
{
DefaultChatChannel = "Trade",
};
storage.Characters["Bob"] = CharacterSettings.Default with
{
ConfirmSalvage = false,
};
var controller = CreateController(storage);
controller.SetActiveCharacter("Alice");
controller.LoadCharacterContext("Alice");
Assert.Equal("Alice", controller.ActiveToonKey);
Assert.Equal("Trade", controller.Character.DefaultChatChannel);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
controller.LoadCharacterContext("Bob");
Assert.Equal("Bob", controller.ActiveToonKey);
Assert.False(viewModel.CharacterDraft.ConfirmSalvage);
controller.RestoreDefaultCharacterContext();
controller.ResetActiveCharacterKey();
Assert.Equal("default", controller.ActiveToonKey);
Assert.Same(storage.DefaultCharacterValue, controller.Character);
Assert.Same(storage.DefaultCharacterValue, viewModel.CharacterDraft);
}
[Fact]
public void CharacterSaveUsesActiveToonAndDefaultSaveBecomesResetContext()
{
var storage = new FakeStorage();
var controller = CreateController(storage);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
var newDefault = CharacterSettings.Default with { AutoAttack = true };
viewModel.SetCharacter(newDefault);
viewModel.Save();
controller.LoadCharacterContext("Alice");
var alice = CharacterSettings.Default with { DefaultChatChannel = "Trade" };
viewModel.SetCharacter(alice);
viewModel.Save();
Assert.Same(newDefault, storage.Characters["default"]);
Assert.Same(alice, storage.Characters["Alice"]);
controller.RestoreDefaultCharacterContext();
Assert.Same(newDefault, controller.Character);
Assert.Same(newDefault, viewModel.CharacterDraft);
}
[Fact]
public void ViewModelAndRuntimeTargetLoansCanBeWithdrawnAndReboundPrecisely()
{
var events = new List<string>();
var controller = CreateController(events: events);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
SettingsVM foreign = CreateStandaloneViewModel(dispatcher);
controller.UnbindViewModel(foreign);
Assert.True(controller.HasDraftPreview);
Assert.Throws<InvalidOperationException>(() =>
controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { }));
controller.UnbindViewModel(viewModel);
Assert.False(controller.HasDraftPreview);
controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
var first = new FakeRuntimeTargets(events);
controller.BindRuntimeTargets(first);
controller.UnbindRuntimeTargets();
var second = new FakeRuntimeTargets(events);
controller.BindRuntimeTargets(second);
controller.SetUiLocked(true);
Assert.Equal(0, first.UiLockCalls);
Assert.Equal(1, second.UiLockCalls);
}
[Fact]
public void OwnedRuntimeTargetsReleaseExactlyAndAllowRebind()
{
var events = new List<string>();
RuntimeSettingsController controller = CreateController(events: events);
var first = new FakeRuntimeTargets(events);
var second = new FakeRuntimeTargets(events);
IDisposable firstBinding = controller.BindRuntimeTargetsOwned(first);
Assert.Throws<InvalidOperationException>(() =>
controller.BindRuntimeTargetsOwned(second));
firstBinding.Dispose();
using IDisposable secondBinding = controller.BindRuntimeTargetsOwned(second);
firstBinding.Dispose();
controller.SetUiLocked(true);
Assert.Equal(0, first.UiLockCalls);
Assert.Equal(1, second.UiLockCalls);
}
[Fact]
public void DisplayPersistenceFailureDoesNotPublishStateOrTargets()
{
var events = new List<string>();
var storage = new FakeStorage(events) { ThrowOnDisplaySave = true };
var logs = new List<string>();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
logs.Add);
storage.ClearEvents();
controller.BindRuntimeTargets(new FakeRuntimeTargets(events));
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
DisplaySettings original = controller.Display;
viewModel.SetDisplay(viewModel.DisplayDraft with
{
Resolution = "2560x1440",
Quality = QualityPreset.Ultra,
});
viewModel.Save();
Assert.Same(original, controller.Display);
Assert.DoesNotContain("target-display", events);
Assert.DoesNotContain("target-quality", events);
Assert.Contains(logs, line => line.Contains("display save failed", StringComparison.Ordinal));
}
[Fact]
public void DisplayTargetFailurePreservesEstablishedStoreThenPublishBoundary()
{
var events = new List<string>();
var storage = new FakeStorage(events);
var logs = new List<string>();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
logs.Add);
storage.ClearEvents();
controller.BindRuntimeTargets(new FakeRuntimeTargets(events)
{
ThrowOnDisplay = true,
});
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
DisplaySettings original = controller.Display;
viewModel.SetDisplay(viewModel.DisplayDraft with
{
Resolution = "3840x2160",
Quality = QualityPreset.Ultra,
});
viewModel.Save();
Assert.Equal(1, storage.DisplaySaves);
Assert.Same(original, controller.Display);
Assert.DoesNotContain("target-quality", events);
Assert.Contains(logs, line => line.Contains("display save failed", StringComparison.Ordinal));
}
[Fact]
public void NonDisplayPersistenceFailuresContinueAndPreserveControllerState()
{
var storage = new FakeStorage
{
ThrowOnAudioSave = true,
ThrowOnGameplaySave = true,
ThrowOnChatSave = true,
ThrowOnCharacterSave = true,
};
var logs = new List<string>();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
logs.Add);
AudioSettings originalAudio = controller.Audio;
GameplaySettings originalGameplay = controller.Gameplay;
ChatSettings originalChat = controller.Chat;
CharacterSettings originalCharacter = controller.Character;
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
viewModel.SetAudio(viewModel.AudioDraft with { Master = 0.1f });
viewModel.SetGameplay(viewModel.GameplayDraft with { LockUI = true });
viewModel.SetChat(viewModel.ChatDraft with { ShowTimestamps = true });
viewModel.SetCharacter(viewModel.CharacterDraft with { AutoAttack = true });
viewModel.Save();
Assert.Same(originalAudio, controller.Audio);
Assert.Same(originalGameplay, controller.Gameplay);
Assert.Same(originalChat, controller.Chat);
Assert.Same(originalCharacter, controller.Character);
Assert.Contains(logs, line => line.Contains("audio save failed", StringComparison.Ordinal));
Assert.Contains(logs, line => line.Contains("gameplay save failed", StringComparison.Ordinal));
Assert.Contains(logs, line => line.Contains("chat save failed", StringComparison.Ordinal));
Assert.Contains(logs, line => line.Contains("character save failed", StringComparison.Ordinal));
}
[Fact]
public void MsaaChangeIsRestartRequiredWhileOtherQualityStateAdvances()
{
var logs = new List<string>();
var events = new List<string>();
var controller = new RuntimeSettingsController(
new FakeStorage(),
static preset => QualitySettings.From(preset),
logs.Add);
controller.BindRuntimeTargets(new FakeRuntimeTargets(events));
controller.ReapplyQualityPreset(QualityPreset.Low);
Assert.Equal(QualitySettings.From(QualityPreset.Low), controller.ResolvedQuality);
Assert.Equal(["target-quality"], events);
Assert.Contains(logs, line =>
line.Contains("MSAA samples change (4 -> 0) requires a restart", StringComparison.Ordinal));
}
[Fact]
public void QualityTargetFailurePublishesResolvedQualityThenPropagates()
{
var events = new List<string>();
var controller = CreateController(events: events);
controller.BindRuntimeTargets(new FakeRuntimeTargets(events)
{
ThrowOnQuality = true,
});
QualitySettings requested = QualitySettings.From(QualityPreset.Ultra);
Assert.Throws<InvalidOperationException>(() =>
controller.ReapplyQualityPreset(QualityPreset.Ultra));
Assert.Equal(requested, controller.ResolvedQuality);
Assert.Equal(["target-quality"], events);
}
[Fact]
public void UiLockTargetFailureCanRetryTheSameRequestedValue()
{
var events = new List<string>();
var storage = new FakeStorage(events);
var controller = CreateController(storage, events);
storage.ClearEvents();
var targets = new FakeRuntimeTargets(events)
{
RemainingUiLockFailures = 1,
};
controller.BindRuntimeTargets(targets);
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
Assert.Throws<InvalidOperationException>(() => controller.SetUiLocked(true));
Assert.True(controller.Gameplay.LockUI);
Assert.Equal(GameplaySettings.Default.LockUI, viewModel.GameplayDraft.LockUI);
Assert.Equal(0, storage.GameplaySaves);
Assert.Equal(["target-ui-lock:True"], events);
events.Clear();
controller.SetUiLocked(true);
Assert.True(controller.Gameplay.LockUI);
Assert.True(viewModel.GameplayDraft.LockUI);
viewModel.Cancel();
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.Equal(1, storage.GameplaySaves);
Assert.Equal(["target-ui-lock:True", "save-gameplay"], events);
}
[Fact]
public void UiLockPersistenceFailureCanRetryTheSameRequestedValue()
{
var events = new List<string>();
var storage = new FakeStorage(events)
{
RemainingGameplaySaveFailures = 1,
};
var logs = new List<string>();
var controller = new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
logs.Add);
storage.ClearEvents();
controller.BindRuntimeTargets(new FakeRuntimeTargets(events));
using InputDispatcher dispatcher = CreateDispatcher();
SettingsVM viewModel = controller.CreateViewModel(
new KeyBindings(),
dispatcher,
static _ => { });
controller.SetUiLocked(true);
Assert.True(controller.Gameplay.LockUI);
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.Equal(1, storage.GameplaySaves);
Assert.Contains(logs, line =>
line.Contains("radar lock save failed", StringComparison.Ordinal));
events.Clear();
controller.SetUiLocked(true);
Assert.True(controller.Gameplay.LockUI);
viewModel.Cancel();
Assert.True(viewModel.GameplayDraft.LockUI);
Assert.Equal(2, storage.GameplaySaves);
Assert.Equal(["target-ui-lock:True", "save-gameplay"], events);
}
[Fact]
public void UnbindingLoansStopsCallsButStateAndPersistenceContinue()
{
var events = new List<string>();
var storage = new FakeStorage(events);
var controller = CreateController(storage, events: events);
storage.ClearEvents();
controller.BindRuntimeTargets(new FakeRuntimeTargets(events));
controller.UnbindRuntimeTargets();
controller.SetUiLocked(true);
controller.ReapplyQualityPreset(QualityPreset.Ultra);
Assert.True(controller.Gameplay.LockUI);
Assert.Equal(
QualitySettings.From(QualityPreset.Ultra),
controller.ResolvedQuality);
Assert.DoesNotContain(events, value => value.StartsWith("target-", StringComparison.Ordinal));
Assert.Equal(1, storage.GameplaySaves);
}
[Theory]
[InlineData("1920x1080", true, 1920, 1080)]
[InlineData(" 800x600 ", true, 800, 600)]
[InlineData("", false, 0, 0)]
[InlineData("1920", false, 0, 0)]
[InlineData("0x1080", false, 0, 1080)]
[InlineData("1920x-1", false, 1920, -1)]
public void ResolutionParserMatchesWindowTargetPolicy(
string spec,
bool expected,
int expectedWidth,
int expectedHeight)
{
bool parsed = SilkRuntimeDisplayWindowTarget.TryParseResolution(
spec,
out int width,
out int height);
Assert.Equal(expected, parsed);
Assert.Equal(expectedWidth, width);
Assert.Equal(expectedHeight, height);
}
private static RuntimeSettingsController CreateController(
FakeStorage? storage = null,
List<string>? events = null)
{
storage ??= new FakeStorage(events);
return new RuntimeSettingsController(
storage,
static preset => QualitySettings.From(preset),
static _ => { });
}
private static InputDispatcher CreateDispatcher()
{
InputDispatcher dispatcher = InputDispatcher.CreateDetached(
new NullKeyboardSource(),
new NullMouseSource(),
new KeyBindings());
dispatcher.Attach();
return dispatcher;
}
private static SettingsVM CreateStandaloneViewModel(InputDispatcher dispatcher) =>
new(
new KeyBindings(),
dispatcher,
static _ => { },
DisplaySettings.Default,
static _ => { },
AudioSettings.Default,
static _ => { },
GameplaySettings.Default,
static _ => { },
ChatSettings.Default,
static _ => { },
CharacterSettings.Default,
static _ => { });
private sealed class FakeStartupTarget(List<string> events)
: IRuntimeSettingsStartupTarget
{
public int RemainingDisplayFailures { get; set; }
public int RemainingAudioFailures { get; set; }
public void ApplyDisplay(DisplaySettings display)
{
events.Add("startup-display");
if (RemainingDisplayFailures > 0)
{
RemainingDisplayFailures--;
throw new InvalidOperationException("display startup failed");
}
}
public void ApplyAudio(AudioSettings audio)
{
events.Add("startup-audio");
if (RemainingAudioFailures > 0)
{
RemainingAudioFailures--;
throw new InvalidOperationException("audio startup failed");
}
}
}
private sealed class FakeRuntimeTargets(List<string> events)
: IRuntimeSettingsTargets
{
public bool ThrowOnDisplay { get; init; }
public bool ThrowOnQuality { get; init; }
public int RemainingUiLockFailures { get; set; }
public int UiLockCalls { get; private set; }
public void ApplyDisplayWindowState(DisplaySettings display)
{
events.Add("target-display");
if (ThrowOnDisplay)
throw new InvalidOperationException("display target failed");
}
public void ApplyQuality(QualitySettings quality)
{
events.Add("target-quality");
if (ThrowOnQuality)
throw new InvalidOperationException("quality target failed");
}
public void ApplyUiLock(bool locked)
{
UiLockCalls++;
events.Add($"target-ui-lock:{locked}");
if (RemainingUiLockFailures > 0)
{
RemainingUiLockFailures--;
throw new InvalidOperationException("UI-lock target failed");
}
}
public List<(uint OptionId, bool Value)> SingleOptionCalls { get; } = [];
public void SetSingleCharacterOption(uint optionId, bool value)
{
SingleOptionCalls.Add((optionId, value));
events.Add($"target-single-option:0x{optionId:X}:{value}");
}
public List<(float DefaultOpacity, float ActiveOpacity)> ChatOpacityCalls { get; } = [];
public void SetChatOpacity(float defaultOpacity, float activeOpacity)
{
ChatOpacityCalls.Add((defaultOpacity, activeOpacity));
events.Add($"target-chat-opacity:{defaultOpacity}:{activeOpacity}");
}
}
// CH3 review S5(b): records every ICommandBus.Publish call so a test can
// assert what the CONCRETE RuntimeSettingsTargets actually put on the
// bus, rather than only what the IRuntimeSettingsTargets fake recorded.
private sealed class CaptureCommandBus : ICommandBus
{
public readonly List<object> Published = new();
public void Publish<T>(T command) where T : notnull =>
Published.Add(command!);
}
private sealed class InspectingDisplayWindowTarget(
Action<DisplaySettings> apply)
: IRuntimeDisplayWindowTarget
{
public int ApplyCount { get; private set; }
public void Apply(DisplaySettings display)
{
ApplyCount++;
apply(display);
}
}
private sealed class RecordingQualityApplicationTarget(List<string> events)
: IRuntimeQualityApplicationTarget
{
private bool _alphaToCoverage;
private int _anisotropic;
private int _near;
private int _far;
private int _streamNear;
private int _streamFar;
private int _budget;
public QualitySettings Observed => new(
_near,
_far,
4,
_anisotropic,
_alphaToCoverage,
_budget);
public void SetAlphaToCoverage(bool enabled)
{
_alphaToCoverage = enabled;
events.Add($"a2c:{enabled}");
}
public void SetAnisotropic(int level)
{
_anisotropic = level;
events.Add($"aniso:{level}");
}
public void PublishRenderRange(int nearRadius, int farRadius)
{
_near = nearRadius;
_far = farRadius;
events.Add($"range:{nearRadius}:{farRadius}");
}
public void ReconfigureStreamingRadii(int nearRadius, int farRadius)
{
_streamNear = nearRadius;
_streamFar = farRadius;
events.Add($"stream:{nearRadius}:{farRadius}");
}
public void SetCompletionBudget(int maxCompletionsPerFrame)
{
Assert.Equal(_near, _streamNear);
Assert.Equal(_far, _streamFar);
_budget = maxCompletionsPerFrame;
events.Add($"budget:{maxCompletionsPerFrame}");
}
}
private sealed class FailingQualityApplicationTarget(
List<string> events,
int failureIndex)
: IRuntimeQualityApplicationTarget
{
private int _step;
public void SetAlphaToCoverage(bool enabled) => Record("a2c");
public void SetAnisotropic(int level) => Record("aniso");
public void PublishRenderRange(int nearRadius, int farRadius) => Record("range");
public void ReconfigureStreamingRadii(int nearRadius, int farRadius) =>
Record("stream");
public void SetCompletionBudget(int maxCompletionsPerFrame) => Record("budget");
private void Record(string step)
{
events.Add(step);
if (_step++ == failureIndex)
throw new InvalidOperationException($"{step} failed");
}
}
private sealed class RecordingUiLockTarget(List<string> events)
: IRuntimeUiLockTarget
{
public void Apply(bool locked) => events.Add($"ui:{locked}");
}
private sealed class FakeStorage(List<string>? events = null)
: IRuntimeSettingsStorage
{
private readonly List<string> _events = events ?? [];
public DisplaySettings DisplayValue { get; set; } = DisplaySettings.Default;
public AudioSettings AudioValue { get; set; } = AudioSettings.Default;
public GameplaySettings GameplayValue { get; set; } = GameplaySettings.Default;
public ChatSettings ChatValue { get; set; } = ChatSettings.Default;
public CharacterSettings DefaultCharacterValue { get; set; } =
CharacterSettings.Default;
public Dictionary<string, CharacterSettings> Characters { get; } =
new(StringComparer.OrdinalIgnoreCase);
public SettingsStore? LayoutStore => null;
public string Location => "memory://settings";
public int DisplayLoads { get; private set; }
public int AudioLoads { get; private set; }
public int GameplayLoads { get; private set; }
public int ChatLoads { get; private set; }
public int CharacterLoads { get; private set; }
public int DisplaySaves { get; private set; }
public int GameplaySaves { get; private set; }
public int ChatSaves { get; private set; }
public string? LastLoadedCharacter { get; private set; }
public bool ThrowOnDisplaySave { get; init; }
public bool ThrowOnAudioSave { get; init; }
public bool ThrowOnGameplaySave { get; init; }
public int RemainingGameplaySaveFailures { get; set; }
public bool ThrowOnChatSave { get; init; }
public bool ThrowOnCharacterSave { get; init; }
public DisplaySettings LoadDisplay()
{
DisplayLoads++;
return DisplayValue;
}
public AudioSettings LoadAudio()
{
AudioLoads++;
return AudioValue;
}
public GameplaySettings LoadGameplay()
{
GameplayLoads++;
return GameplayValue;
}
public ChatSettings LoadChat()
{
ChatLoads++;
return ChatValue;
}
public CharacterSettings LoadCharacter(string toonKey)
{
CharacterLoads++;
LastLoadedCharacter = toonKey;
return Characters.TryGetValue(toonKey, out CharacterSettings? value)
? value
: DefaultCharacterValue;
}
public void SaveDisplay(DisplaySettings display)
{
DisplaySaves++;
_events.Add("save-display");
if (ThrowOnDisplaySave)
throw new IOException("display persistence failed");
DisplayValue = display;
}
public void SaveAudio(AudioSettings audio)
{
_events.Add("save-audio");
if (ThrowOnAudioSave)
throw new IOException("audio persistence failed");
AudioValue = audio;
}
public void SaveGameplay(GameplaySettings gameplay)
{
GameplaySaves++;
_events.Add("save-gameplay");
if (RemainingGameplaySaveFailures > 0)
{
RemainingGameplaySaveFailures--;
throw new IOException("gameplay persistence failed");
}
if (ThrowOnGameplaySave)
throw new IOException("gameplay persistence failed");
GameplayValue = gameplay;
}
public void SaveChat(ChatSettings chat)
{
ChatSaves++;
_events.Add("save-chat");
if (ThrowOnChatSave)
throw new IOException("chat persistence failed");
ChatValue = chat;
}
public void SaveCharacter(string toonKey, CharacterSettings character)
{
_events.Add($"save-character:{toonKey}");
if (ThrowOnCharacterSave)
throw new IOException("character persistence failed");
Characters[toonKey] = character;
if (string.Equals(toonKey, "default", StringComparison.OrdinalIgnoreCase))
DefaultCharacterValue = character;
}
public void ClearEvents() => _events.Clear();
}
private sealed class FakeClock : IFramePacingClock
{
public long Frequency => 1_000;
public long GetTimestamp() => 0;
}
private sealed class NullWaiter : IFramePacingWaiter
{
public void Wait(long durationTicks, long clockFrequency)
{
}
}
private sealed class FakePacingSurface : IDisplayFramePacingSurface
{
private int? _refreshRate;
public bool VSync { get; set; }
public int RefreshReadCount { get; private set; }
public int? ActiveMonitorRefreshHz
{
get => _refreshRate;
set => _refreshRate = value;
}
public bool TryGetActiveMonitorRefreshHz(out int refreshHz)
{
RefreshReadCount++;
refreshHz = _refreshRate.GetValueOrDefault();
return _refreshRate is > 0;
}
}
private sealed class NullKeyboardSource : IKeyboardSource
{
#pragma warning disable CS0067
public event Action<Key, ModifierMask>? KeyDown;
public event Action<Key, ModifierMask>? KeyUp;
#pragma warning restore CS0067
public bool IsHeld(Key key) => false;
public ModifierMask CurrentModifiers => ModifierMask.None;
}
private sealed class NullMouseSource : IMouseSource
{
#pragma warning disable CS0067
public event Action<MouseButton, ModifierMask>? MouseDown;
public event Action<MouseButton, ModifierMask>? MouseUp;
public event Action<float, float>? MouseMove;
public event Action<float>? Scroll;
#pragma warning restore CS0067
public bool IsHeld(MouseButton button) => false;
public bool WantCaptureMouse => false;
public bool WantCaptureKeyboard => false;
}
}