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

BeforeNowMigration
ArionTexts.UseGermanTexts() / UseEnglishTexts() (instance and static)UseGerman() / UseEnglish()Rename the call. New: Use(CultureInfo). Every German culture gives German, every other culture English.
ArionTexts.UseGermanAccessibilityTexts() / UseEnglishAccessibilityTexts()UseGermanAccessibility() / UseEnglishAccessibility()Rename the call.
ArionUiText.UseGermanTexts() / UseEnglishTexts() and the accessibility variantsUseGerman() / 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.

BeforeNowMigration
ColumnDefinition<T>.Header (string)LocalTextWhen 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.
Column.* factory methods (Text, Checkbox, CheckboxDisplay, Badge, Tag, Bullet, Variance, Button, Tree, Composed, Donut, MiniStack, HeatStrip, Sparkline, ColumnSpark) and TypedColumn.Number, Date, Enum: parameter string headerLocalText headerNone, as long as a string is passed. Adapt method groups or delegate assignments with a fixed string parameter.
RowMarker(Color, Shape, string? Text, string? Tooltip, ...): Text and TooltipLocalTextWhen reading Text and Tooltip, use Resolve(). null as an argument becomes default.
Placeholder of ComboBox, TextArea and TextFieldWidget, MenuBarItem.Caption: string; AccessibleName of cell elements (SlotEl): string?LocalTextWhen reading, use Resolve(). Assigning a string still works. Control.AccessibleName is unchanged.
ColumnDefinition<T>.Style(when, Rgba? foreground, bold, Rgba? background)Style(when, StyleColor? foreground, bold, StyleColor? background)None: Rgba converts implicitly to StyleColor.

ArionUI.Presentation: other changes

BeforeNowMigration
ArionTexts.QuickSearchFooter (Func<int?, string>, instance and static)Func<int?, bool, string>Add the second bool parameter to the lambda.
PivotAddField / PivotAddValue on PivotTexts and PivotUiTextremovedRemove assignments to these two texts.
ValueFilterDescriptor(int ElementId, IReadOnlyList<string> Allowed)additional parameter IReadOnlyList<string>? Keys = nullNone for calls. A deconstruction now needs three variables.
VisibleStripContextremovedNone; the class was meant only for internal drawing paths.
IGridViewOps, own implementationsnew members ActiveValueFilterKeys, SetValueFilterKeys, CanSortBy, FiltersInPaneLook, IsDataGrid, QueryViewVersionCode 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

BeforeNowMigration
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.
LiveSeries(int capacity, double? sampleRate = null)LiveSeries(int capacity, double sampleRate, TimeSpan start = default, LiveSeriesPrecision precision = Double)Pass the sampling rate. A reading's time now follows from its place.
LiveSeries.Append(readings, firstAt, spacing) and DroppedremovedAppend with Append(readings). Give missing readings as NaN or with AppendGap(count), and call Restart when the source begins again.
ArionUiText.LiveSmoothing / ArionTexts.LiveSmoothing (Func<TimeSpan?, string>)LiveBuffer (Func<TimeSpan, bool, string>)Pass the delay in force and whether it is measured: LiveBuffer(clock.DelayInForce, clock.Delay is null).

ArionUI.Grid and the hosts (Avalonia, WPF, WinForms)

BeforeNowMigration
ArionUI.Rendering.Avalonia.RendererKind { Bitmap, Gpu }ArionUI.Grid.RendererKind { None, Bitmap, Gpu }using ArionUI.Grid; instead of using ArionUI.Rendering.Avalonia;. Before the first frame Avalonia reports None instead of Bitmap.
CanUserReorderColumns = false hid the column chooserit no longer hides itTo hide it, set CanUserHideColumns = false. The property is new on all hosts.

ArionUI.Rendering.Avalonia

BeforeNowMigration
type of ArionGrid.ActiveRenderer is Avalonia.RendererKindGrid.RendererKindSwitch comparisons to the new type.

ArionUI.Rendering.Wpf

BeforeNowMigration
diagnostic values directly on ArionGrid (AverageDrawMs, AverageFlushMs, AverageFrameMs, AverageSharedMs, AverageSwapMs, FramesTotal, BlitFrames, FullFrames, DrawnSlots, VisibleSlots, VisibleShape, ShapeInputs, LastProduceMs, LastPresentMs, LastSetupMs, LastSolveMs, LastWaitMs, LastChromeMs, SurfaceSplit, ToggleRequested)grid.Diagnostics.<Name> (type ArionGridDiagnostics)Replace grid.X with grid.Diagnostics.X.
ArionGrid.D3DChainSelfTestArionGridDiagnostics.D3DChainSelfTestCall ArionGridDiagnostics.D3DChainSelfTest(log).
ArionGrid.VsyncOnremovedThe value was always true; remove the query.
ArionGrid.BlitEnabledGpuScrollBlitRename the property, as on Avalonia and WinForms.

ArionUI.Rendering.WinForms

BeforeNowMigration
ArionGridControl.ScrollBarGlideTime (seconds, default 0.045)ScrollBarGlideMs (milliseconds, default 45)Rename and multiply the value by 1000.

ArionUI.Layout

BeforeNowMigration
GridLayoutFile.TryLoad(path, apply, log) / TrySave(path, capture, log)removedSave 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

BeforeNowMigration
PieDefinition.HoleRatioPieDefinition.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).

ArionUI.Pivot

BeforeNowMigration
PivotFieldModel.ValueFields: List<(string Measure, PivotValueDisplay Display, PivotValueVisual Visual)>List<PivotValue>Replace the tuple with new PivotValue(measure, display, visual). New: AddValue(PivotValue); AddValue(string, ...) remains.
PivotSpec.GrandTotalLabel and the constructor parameter: string = "Total"string? = nullnull takes the text from the language switch. If you need "Total", pass it explicitly.
PivotView.CornerClickedSettingsRequestedHandle SettingsRequested, raised on a click on the settings button in the corner.
PivotTemplate.RenderCaption(...)removedNone; the method was meant for the internal drawing path.

ArionUI.Planning

BeforeNowMigration
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.

ArionUI.Export, ArionUI.Formatting, ArionUI.Grouping, ArionUI.Charts3D, ArionUI.Data

  • 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.

Packages

ZonePackages
Core, Apache-2.0ArionUI.Core, ArionUI.Presentation, ArionUI.Grid, ArionUI.Gpu, ArionUI.Rendering.Skia, ArionUI.Rendering.Avalonia, ArionUI.Rendering.Wpf, ArionUI.Rendering.WinForms, ArionUI.Data
Pro, preview licenceArionUI.Grouping, ArionUI.Pivot, ArionUI.Charts, ArionUI.Charts3D, ArionUI.Timeline, ArionUI.Planning, ArionUI.Formatting, ArionUI.Layout, ArionUI.Export

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.