Leonid PershinandClaude Opus 5
3db9d4dfc6
Greenfield skeleton for a parser desktop app. The domain is deliberately a placeholder — IParser<TIn,TOut> plus two sample parsers — so the shell is runnable and verifiable end to end before real logic lands. Layers run one way: Core (no Avalonia, no IO) <- Infrastructure <- UI <- Desktop. UI is a class library rather than the exe so headless tests build real views without dragging in Program.cs, Serilog or the container. Adaptive layout is built from what Avalonia actually offers, since it has no AdaptiveTrigger or media queries: ResponsiveLayout observes Visual.Bounds and projects a breakpoint onto both an attached property and :compact/:medium/ :expanded pseudoclasses, with 24px hysteresis so dragging a window edge cannot make the layout flap. Pane state lives in the view model because a style setter loses to a local value permanently; styles own only the visual variance. Stack notes worth remembering: Avalonia.ReactiveUI is deprecated in favour of ReactiveUI.Avalonia, and ReactiveUI 24 runs on the Primitives engine (RxVoid, ISequencer, Signal<T>) and no longer self-initialises. Avalonia.Headless.XUnit 12.x requires xUnit v3. InvariantGlobalization must stay false or Semi.Avalonia throws in its static constructor. 102 tests across three projects, including headless guards for the two failures that are otherwise completely silent: a stylesheet whose selectors match nothing, and a light palette too low-contrast for cards to read. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
AvParser
Каркас desktop-приложения на Avalonia 12 с ReactiveUI-MVVM, адаптивным layout поверх Semi.Avalonia, единым DI-контейнером и тремя уровнями тестов.
Доменная часть пока намеренно абстрактная: ядро — это pluggable-контракт
IParser<TInput, TOutput> и два демо-парсера, чтобы каркас был запускаемым и проверяемым
end-to-end до появления настоящей логики.
Быстрый старт
Нужен .NET SDK 10.0.100 (закреплён в global.json).
dotnet restore AvParser.slnx
dotnet build AvParser.slnx -c Release
dotnet test AvParser.slnx -c Release
dotnet run --project src/AvParser.Desktop
Форматирование (csharpier — единственный владелец форматирования, включая .axaml и .csproj):
dotnet tool restore && dotnet csharpier check .
Структура
src/
AvParser.Core домен: IParser, IParserCatalog, модели, демо-парсеры
ноль зависимостей кроме DI.Abstractions — ни Avalonia, ни IO
AvParser.Infrastructure AppPaths, JSON-настройки с debounce, Serilog
AvParser.UI Avalonia class library: App-независимые View, ViewModel,
ResponsiveLayout, дизайн-токены, навигация
AvParser.Desktop WinExe-хост: Program.cs, App.axaml, composition root
tests/
AvParser.Core.Tests парсеры, реестр, отмена, прогресс
AvParser.UI.Tests ViewModel'и без Avalonia
AvParser.UI.HeadlessTests реальное дерево контролов через [AvaloniaFact]
Ссылки идут строго в одну сторону: Core ← Infrastructure ← UI ← Desktop.
UI — библиотека, а не exe, именно чтобы headless-тесты собирали настоящие View, не подтягивая
Program.cs, Serilog и контейнер.
Адаптивный layout
В Avalonia нет AdaptiveTrigger, VisualStateManager и media-queries. Есть три примитива:
наблюдаемый Visual.Bounds, псевдоклассы и SplitView. ResponsiveLayout связывает первое со
вторым — получается CSS-подобная реакция на ширину.
| Брейкпоинт | Ширина окна | Навигация |
|---|---|---|
| Compact | < 720 px | выезжающий drawer поверх контента |
| Medium | 720 – 1100 px | рельс из одних иконок (56 px) |
| Expanded | ≥ 1100 px | полный сайдбар с подписями (248 px) |
Переключение с гистерезисом в 24 px: без неё перетаскивание края окна заставляет layout мигать между двумя состояниями на каждом пикселе дрожания.
Разделение обязанностей, которое важно не сломать:
SplitView.DisplayModeиIsPaneOpenбиндятся во ViewModel. Style-сеттер навсегда проигрывает локальному значению, поэтому первый же клик по гамбургеру заморозил бы любой стиль, который тоже пишет в эти свойства.- Всё чисто визуальное — ширины панели, видимость подписей, паддинги — живёт в
Styles/Shell.axaml.
Селекторы там написаны как :is(UserControl).shell, а не UserControl.shell: селектор типа в
Avalonia матчит точный тип, а ShellView наследуется от ReactiveUserControl<T> — обычная
форма молча не сматчилась бы ни с чем. На это есть тест
(ShellViewTests.The_shell_stylesheet_is_actually_applied).
Дизайн-токены
Все цвета, отступы, радиусы и типографика — в Styles/Tokens.axaml, с отдельными словарями
для Light и Dark. В остальном XAML нет ни одного литерального цвета и ни одного «магического»
отступа, так что перекрасить тему или уплотнить интерфейс — это правка одного файла.
Semi.Avalonia даёт темы контролов; токены — это семантический слой приложения поверх них.
Кнопки .primary / .destructive описаны своими стилями, а не классами Semi, чтобы акцентный
цвет не разъезжался между двумя палитрами.
Стек
| Пакет | Версия | Заметка |
|---|---|---|
| Avalonia | 12.1.1 | compiled bindings по умолчанию → x:DataType обязателен |
| ReactiveUI.Avalonia | 12.1.1 | Avalonia.ReactiveUI — deprecated, это его преемник |
| ReactiveUI | 24.1.0 | дистрибутив Primitives: RxVoid вместо Unit, ISequencer вместо IScheduler |
| Semi.Avalonia | 12.1.0.1 | темы контролов |
| xUnit | v3 (3.2.2) | Avalonia.Headless.XUnit 12.x требует именно v3 |
Что проверить руками
- Потянуть окно по ширине — сайдбар проходит путь
полный → только иконки → выезжающий drawer, без мигания на границах. - Переключить тему кнопкой в заголовке и в Settings; перезапустить — выбор сохранился.
- На странице Parse нажать 50k rows, затем Parse — виден прогресс; Cancel останавливает на середине и пишет, сколько успело разобраться.
F12в Debug-сборке открывает Avalonia DevTools — там видно, как переключаются:compact/:medium/:expanded.
Настройки и логи лежат в %APPDATA%/AvParser (Windows) или ~/.config/AvParser (Linux/macOS).