PreviewEarly preview 0.1.0-preview.2 — the API may change, not yet recommended for production.Early preview — the API may change.Feedback welcome →
Release notes
What each version contains and what changed in behaviour. The packages on nuget.org carry the same notes; the repository carries the full history.
0.1.0-preview.2
Released .
The second preview. The packages, hosts and target frameworks are those of 0.1.0-preview.1. New underneath: ArionUI.Rendering.Skia brings Vortice.Direct3D11 and Vortice.DirectComposition 3.8.3 to every host, and the Avalonia and WPF hosts now bring ArionUI.Data. What changed is below. The API still moves between preview versions.
What is new
Columns scale like rows: a million columns by a hundred million rows held 60 Hz on Avalonia, WPF and WinForms, at around a millisecond per frame wherever you have scrolled to. Setting up a million columns takes about five seconds and 1.8 GB, once, before the first picture (measurements).
Scrolling allocates no memory per frame on the GPU path. This is measured, and a test guards it.
Live data: groups, sums, conditional formatting and the selection sum follow changed values row by row, without a rebuild.
WinForms is measured in the same benchmark as Avalonia and WPF.
Disabled input fields share one disabled look and no longer react to the pointer.
Breaking changes
The old names are removed; there is no [Obsolete]. Source code that uses one of the members below needs a change. Everything else compiles unchanged.
ArionUI.Presentation: language switch
Before
Now
Migration
ArionTexts.UseGermanTexts() / UseEnglishTexts() (instance and static)
UseGerman() / UseEnglish()
Rename the call. New: Use(CultureInfo). Every German culture gives German, every other culture English.
ArionUiText.UseGermanTexts() / UseEnglishTexts() and the accessibility variants
UseGerman() / UseEnglish() and UseGermanAccessibility() / UseEnglishAccessibility()
Rename the call.
GridContext.UseGermanTexts() / UseEnglishTexts()
UseGerman() / UseEnglish()
Rename the call; Use(CultureInfo) is optional.
IArionTextCatalogue.German() / English()
UseGerman() / UseEnglish() and Use(CultureInfo)
Your own implementations must provide Use, UseGerman and UseEnglish. IsGerman and UseLanguageOf are static members of the interface.
ChartTexts, Scene3DTexts, FormattingTexts, GroupingTexts, PivotTexts and the static facades (ChartUiText.German() and so on): German() / English()
UseGerman() / UseEnglish(), new Use(CultureInfo)
Rename the call. Details are under each package. ExportTexts is new in this version.
ArionUI.Presentation: texts as LocalText
Column headers, band names and other captions are now of type LocalText. A string can still be passed directly, because there is an implicit conversion. Errors only appear where the value is read and used further as a string.
Before
Now
Migration
ColumnDefinition<T>.Header (string)
LocalText
When reading, use Header.Resolve() or Header.ToString().
ColumnDefinition<T>.BandPath and Band(params string[]): IReadOnlyList<string>?
IReadOnlyList<LocalText>?
Replace an assigned list of string with a list of LocalText. When reading, use Resolve(). Band("A", "B") stays valid.
None for calls. A deconstruction now needs three variables.
VisibleStripContext
removed
None; the class was meant only for internal drawing paths.
IGridViewOps, own implementations
new members ActiveValueFilterKeys, SetValueFilterKeys, CanSortBy, FiltersInPaneLook, IsDataGrid, QueryViewVersion
Code that calls the interface stays valid: ActiveValueFilter, SetValueFilter and the other filter and sort members now come from its base interface IValueFilterSource. An own implementation adds the new members.
ArionUI.Core and ArionUI.Presentation: live data
Before
Now
Migration
LivePlayback with Advance(elapsed, series)
LiveClock(series)
Make one clock per view, for the series the source writes last. There is no Advance: the position is worked out per frame. Read, ValueOf and RangeOf take a FrameTarget as second argument, FrameTarget.Current on the UI thread. Position is PositionAt(target), DelayFor(series) is DelayInForce.
Save and load through a stream: grid.Api.SaveLayout(view, stream) and grid.Api.LoadLayout(view, stream), which returns a LayoutLoadResult. The application creates the file itself. New: api.EnableLayoutMenu(view) adds a layout menu whose SaveLayoutRequested and LoadLayoutRequested events hand over the stream. ArionLayoutSerializer for JSON remains.
ArionUI.Charts
Before
Now
Migration
PieDefinition.HoleRatio
PieDefinition.Look.HoleRatio (new type PieLook)
Look = PieLook.Donut with { HoleRatio = 0.6 }. The presets are Flat, Donut, Relief, Outline, Rings, Stage.
PieDefinition.LegendHeight (double)
LegendRows (int)
Give the maximum number of legend rows instead of a height in pixels (default 3).
Replace the tuple with new PivotValue(measure, display, visual). New: AddValue(PivotValue); AddValue(string, ...) remains.
PivotSpec.GrandTotalLabel and the constructor parameter: string = "Total"
string? = null
null takes the text from the language switch. If you need "Total", pass it explicitly.
PivotView.CornerClicked
SettingsRequested
Handle SettingsRequested, raised on a click on the settings button in the corner.
PivotTemplate.RenderCaption(...)
removed
None; the method was meant for the internal drawing path.
ArionUI.Planning
Before
Now
Migration
PlanningBuilder<T>.Rollup(AggregateFn fn = Sum)
Rollup()
Remove the argument. The aggregate function is set per measure through the rollup parameter of Measure.
ArionUI.Timeline and ArionUI.Charts: members for the internal drawing path
Timeline: TimelineDefinition.EdgeMarkWidth and SetVisibleContent are removed.
Charts: RenderPresentStamps of ChartDefinition, HeatmapDefinition, PieDefinition and ScatterDefinition takes a RenderContext instead of engine, scroll offset and content rectangle.
Both were meant only for the internal drawing path; application code does not call them.
Only the language switch, German() / English() to UseGerman() / UseEnglish() (Formatting, Grouping, Charts3D), see above.
Export: ExportCsv, ExportCsvToFile, ExportXlsx and ExportXlsxToFile have new optional parameters (separatorLine, sheetName). Source code stays valid; only binary compatibility changes. Recompile.
Changed behaviour
The pivot freezes its row headers by default (PivotView.FreezeRowHeaders = true). Turn it off with FreezeRowHeaders = false.
Area series (ChartSeriesKind.Area) include zero in the scale and fill down to zero instead of to the bottom edge.
PivotSource.NumberFormat now applies before a measure's own format. Counts stay whole numbers.
Pivot: sorting by a row header goes A-Z, Z-A, off, and by caption instead of by key.
Pivot: "Reset" in the field list returns to the starting arrangement.
CanUserReorderColumns = false no longer hides the column chooser; see CanUserHideColumns.
Data bars of conditional formatting can start at zero when needed (BarsFromZero, off by default).
PlanningBuilder<T>: the default format of Measure and Calculated is now #,0.## instead of 0.## (thousands separator).
Grouping chips (ChipW) are 220 instead of 150 wide.
Avalonia: ActiveRenderer reports None before the first frame.
FallbackReason now also exists on WPF and WinForms. There the value is always null.
Avalonia and WPF now depend on ArionUI.Data. The package comes along as a dependency.
ScrollBarGlide and ScrollBarGlideMs now exist directly on all three hosts.
Live data: LiveClock.Delay = TimeSpan.Zero does not show the newest reading in every frame, as LivePlayback did. The trace runs on evenly, and the readings a packet brings show as a gap at the right edge until it comes. See Live data.
Known limitations
Touch is still in progress: one finger works like a mouse, gestures are not finished. The limitations of 0.1.0-preview.1 below still apply; the full list is on What it does not do yet.
0.1.0-preview.1
Released .
The first public preview. The API still moves, and breaking changes are expected between preview versions. It is not recommended for production systems yet; feedback is welcome as issues.
The WinForms host brings the native ANGLE runtime (Avalonia.Angle.Windows.Natives) and ArionUI.Data along.
Requirements
.NET 10: net10.0, the WPF host net10.0-windows, the WinForms host net10.0-windows10.0.19041.
Avalonia 12.1.0 for the Avalonia host. SkiaSharp 3.119.4 and HarfBuzzSharp 8.3.1.5 underneath; Vortice.Direct3D11 and Vortice.Direct3D9 3.8.3 for the WPF host.
What is in it
One engine and renderer for Avalonia, WPF and WinForms; GPU drawing by default with an automatic CPU path on Avalonia. On the GPU path a table's plain cells are drawn by ArionUI's own shader program, kept compiled on disk after the first start (Hosting and rendering).
Views: table, card board, tree, board of tiles — and with Pro: pivot, charts, 3D charts, timeline, planning matrix.
Board & Styling (preview): a layout grid with breakpoints, splitters, tiles the user can move and dock, and split areas with tab groups; typed style sheets with a cascade, tokens, transitions and Explain; view tiles. With Pro: saving a board layout.
Drawn controls (preview): buttons, text box and text area, check box, switch, radio groups, combo box, numeric up-down, date picker, slider, tabs, menu bar, toolbar, context menus, image, tooltips and a validation state; board.Bind to view models.
Modernising WinForms and WPF: ArionGridControl.DataSource for a DataTable, a DataView, a list of objects (BindingList<T>, List<T>) or a BindingSource over one; DataTableItemsSource, Column.FromDataTable and DataErrorEditPolicy for any host; ArionTheme.FromSystem() and FollowSystem; a sample that walks one form through three steps.
Columns: text, typed number, date and enum, badge, tag, button, checkbox, composed cells, micro-charts, banded headers, master-detail, tree columns, columns generated from a type.
Data: list, observable, keyed upsert, ring buffer, paged virtual and server-side sources.
Sorting with multiple levels and a sort culture; filter row with typed operators; value filters; search with highlighting; a quick-search palette.
Editing with drawn editors, masks, validators, an edit policy, undo and redo, paste, fill-down and a commit pipeline.
The consumer facade grid.Api, bindable properties and ICommand inputs on all hosts.
UI Automation on all three hosts, tested with Narrator and NVDA; high-contrast themes followed automatically; reduced motion.
Seven built-in themes; per-grid texts, icons and cultures. Texts in English by default, German with UseGermanTexts(); date formats from the culture.
Pro: grouping, pivot with field list and drill-down, conditional formatting with a rule manager, layout persistence, CSV, XLSX and PDF export.
4,415 automated tests in five suites were green in the repository's gate on 22 October 2026.
Behaviour to know
These notes travel in the ArionUI.Core package. They concern code built against earlier, unpublished builds and defaults that a first-time user meets:
The guide of a sparkline follows the pointer by default: Column.Sparkline and Cell.Sparkline default to interpolate: true. Pass interpolate: false to snap to the points.
SparklineEl.Curve has a set accessor instead of init, because the user switches it from the menu.
IGridViewOps has two new members, LineCurveOf and SetLineCurve; an own implementation has to add them.
ArionIcons.CheckBox takes five arguments; the accent colour comes last. Pass Palette.Accent for the theme's colour.
The built-in texts are English by default, the Pro modules' included. ArionUiText.UseGermanTexts() switches every catalogue of the context; Scene3DUiText.German() and the other module calls switch one.
TypedColumn.Date without a format shows the short date of the column's culture, no longer a fixed dd.MM.yyyy.
Known limitations
No touch gestures beyond one finger, no mirrored right-to-left layout, no IME pre-edit in the cell, no floating panels in windows of their own, no native control inside a board tile, and gaps in screen-reader support on Avalonia. The full list is on What it does not do yet.