## What Brings AppKit into conformance with [KofTwentyTwo/standards](https://github.com/KofTwentyTwo/standards). Reviewable commit by commit: | Commit | Change | | --- | --- | | build | Quality gate from `configs/dotnet` (analyzers incl. Meziantou, warnings as errors), `packages.lock.json` per project, locked-mode restore | | style | Kingsrook layout and LF line endings, produced mechanically by `dotnet format` (formatting only) | | docs | SPDX license header on every C# file | | refactor | Real code changes: analyzer findings fixed (one type per file, regex timeouts, async void, …) and header comments on every type and member | | ci | Old workflows replaced by callers of the shared standards workflows (PR gates, security, CodeQL, .NET CI, NuGet release with SBOM + attestation + trusted publishing), Scorecard | | docs | README, CONTRIBUTING (GitHub Flow, DCO, signing), SECURITY, CODEOWNERS, templates, Dependabot, threat model, ADRs, RELEASING | Also includes `dev`'s CI fix, so it supersedes #1; the `dev` branch goes away under GitHub Flow. ## Why AppKit is the first Product repository to adopt the standards. Static conformance before: 16 FAIL; after: 0 FAIL, 0 WARN (the remaining UNKNOWN rows are GitHub settings and rulesets, applied separately). ## How tested Locally with `CI=true` (lock files enforced): locked restore x64 and ARM64; zero-warning x64 build; 115 unit tests with 100% line coverage of `KofTwentyTwo.AppKit` and `KofTwentyTwo.AppKit.Updates`; 12 FlaUI UI tests (WinUI + WPF samples); `dotnet format --verify-no-changes --severity warn` clean; pack produces 4 packages + symbols; actionlint, zizmor (pedantic), gitleaks clean. The UI tests caught a regression introduced while fixing MA0147 (the WPF splash stopped dismissing because no UI context existed yet); fixed by starting the countdown through the dispatcher in both packages. ## Notes - `ci.yml` and `release.yml` are pinned to KofTwentyTwo/standards#3's head commit; they are repinned after that PR merges. - This pull request's new check names become required checks once the repository's rulesets are updated. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Signed-off-by: James Maes <james@kof22.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
147 lines
4.7 KiB
C#
147 lines
4.7 KiB
C#
/*
|
|
* Copyright (c) 2026 James Maes (KofTwentyTwo)
|
|
* SPDX-License-Identifier: MIT
|
|
*/
|
|
|
|
using KofTwentyTwo.AppKit.Settings;
|
|
using KofTwentyTwo.AppKit.Updates;
|
|
using KofTwentyTwo.AppKit.WinUI;
|
|
using Microsoft.UI.Xaml;
|
|
|
|
|
|
namespace AppKit.Sample.WinUI;
|
|
|
|
/// <summary>The sample's main window: each control exercises one AppKit service.</summary>
|
|
public sealed partial class MainWindow : Window
|
|
{
|
|
private readonly SampleSettings _settings = SampleApp.SettingsStore.Load();
|
|
private readonly UpdateCoordinator _updates;
|
|
|
|
|
|
|
|
/// <summary>Sizes and brands the window, wires the update coordinator, restores the saved settings, shows the splash, and schedules the quiet startup update check.</summary>
|
|
public MainWindow()
|
|
{
|
|
InitializeComponent();
|
|
Title = SampleApp.Info.DisplayName;
|
|
this.ResizeForDpi(900, 600);
|
|
this.SetMinimumSize(640, 420);
|
|
this.SetAppIcon(SampleApp.Info);
|
|
|
|
_updates = new UpdateCoordinator(
|
|
new VelopackUpdateService(SampleApp.Info.RepositoryUrl!),
|
|
new ContentDialogPrompter(() => Content.XamlRoot),
|
|
SampleApp.Info.DisplayName,
|
|
App.Log);
|
|
|
|
GreetingText.Text = _settings.Greeting;
|
|
SplashToggle.IsChecked = _settings.ShowSplashScreen;
|
|
(_settings.ThemeKind switch { AppTheme.Light => ThemeLight, AppTheme.Dark => ThemeDark, _ => ThemeSystem }).IsChecked = true;
|
|
|
|
SplashOverlay.ShowOver(RootGrid, SampleApp.Info, _settings);
|
|
Closed += (_, _) => LogWindow.CloseCurrent(); // a log-only process would linger otherwise
|
|
|
|
if(_settings.CheckForUpdatesOnStartup)
|
|
{
|
|
// The constructor runs on the UI thread, so the check resumes there to show dialogs.
|
|
_ = CheckForUpdatesAfterStartupAsync();
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// Waits for the splash to clear (dialogs need the window's XamlRoot), then runs the
|
|
/// quiet startup update check, which only speaks up when an update exists.
|
|
/// </summary>
|
|
private async Task CheckForUpdatesAfterStartupAsync()
|
|
{
|
|
await Task.Delay(_settings.ShowSplashScreen ? _settings.SplashMilliseconds + 500 : 1000);
|
|
await _updates.CheckQuietlyAsync();
|
|
}
|
|
|
|
|
|
|
|
/// <summary>File, Exit.</summary>
|
|
private void Exit_Click(object sender, RoutedEventArgs e) => Close();
|
|
|
|
|
|
|
|
/// <summary>View, theme: applies the chosen theme to the window and saves it.</summary>
|
|
private void Theme_Click(object sender, RoutedEventArgs e)
|
|
{
|
|
_settings.Theme = (string)((FrameworkElement)sender).Tag;
|
|
WinUIShell.ApplyTheme(RootGrid, _settings.ThemeKind);
|
|
Save();
|
|
}
|
|
|
|
|
|
|
|
/// <summary>View, Show splash at startup: saves the preference.</summary>
|
|
private void Splash_Click(object sender, RoutedEventArgs e)
|
|
{
|
|
_settings.ShowSplashScreen = SplashToggle.IsChecked;
|
|
Save();
|
|
}
|
|
|
|
|
|
|
|
/// <summary>Help, Check for updates: runs the interactive update flow.</summary>
|
|
private async void CheckForUpdates_Click(object sender, RoutedEventArgs e) => await _updates.CheckInteractivelyAsync();
|
|
|
|
|
|
|
|
/// <summary>Help, Activity log: opens the live log window, or brings the open one forward.</summary>
|
|
private void ActivityLog_Click(object sender, RoutedEventArgs e) => LogWindow.ShowSingle(App.Log, SampleApp.Info);
|
|
|
|
|
|
|
|
/// <summary>Help, About: shows the About dialog.</summary>
|
|
private async void About_Click(object sender, RoutedEventArgs e) => await AboutDialog.ShowAsync(SampleApp.Info, Content.XamlRoot);
|
|
|
|
|
|
|
|
/// <summary>Writes an INFO entry, to show logging.</summary>
|
|
private void LogInfo_Click(object sender, RoutedEventArgs e)
|
|
{
|
|
App.Log.Info("The user pressed 'Write a log entry'.");
|
|
StatusText.Text = "Wrote an INFO entry.";
|
|
}
|
|
|
|
|
|
|
|
/// <summary>Logs a handled exception with its stack trace, to show error logging.</summary>
|
|
private void LogError_Click(object sender, RoutedEventArgs e)
|
|
{
|
|
try
|
|
{
|
|
throw new InvalidOperationException("A deliberately handled sample failure.");
|
|
}
|
|
catch(InvalidOperationException ex)
|
|
{
|
|
App.Log.Error("Sample operation failed.", ex);
|
|
StatusText.Text = "Wrote an ERROR entry with its stack trace.";
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/// <summary>Throws on purpose, to show that the crash net logs the exception and the app keeps running.</summary>
|
|
private void Throw_Click(object sender, RoutedEventArgs e)
|
|
{
|
|
StatusText.Text = "Threw; the crash net logged it and the app kept running.";
|
|
throw new InvalidOperationException("Deliberately unhandled sample exception.");
|
|
}
|
|
|
|
|
|
|
|
/// <summary>Saves the settings and reports a failed save in the status line.</summary>
|
|
private void Save()
|
|
{
|
|
if(!SampleApp.SettingsStore.Save(_settings))
|
|
{
|
|
StatusText.Text = "Could not save settings.";
|
|
}
|
|
}
|
|
}
|