ArcadioG.Ananke 0.4.0

Ananke

Ananke is a WinUI 3 control library, aptly named after the mythological personification of necessity and a satellite of Jupiter. Which is to say, it is the place where I (Arcadio) put controls that I made cause I needed and weren't part of WinUI.

Controls

RadarControl

RadarControl is an accessible, animated radial vector editor:

• arbitrary linear ranges and three or more axes;
• multiple series with one active series;
• Win2D rendering through an internal renderer boundary;
• mouse, touch, pen, keyboard, and UI Automation editing;
• host-coercible whole-vector edit proposals;
• Fluent light/dark/high-contrast colors and non-color series cues;
• directional, bounds-aware axis labels that wrap outside the plot polygon;
• elapsed-time, retargetable animation with a paused-while-idle render loop.

EditableTagCollection

EditableTagCollection is a compact, accessible editor for wrapping collections of stable-identity text tags:

• content-sized Fluent chips that reflow with the available width;
• add and rename editors that grow with live text up to the available collection width;
• a trailing progress ring that replaces the remove affordance while persistence is pending;
• add, inline rename, and remove workflows for pointer, touch, pen, and keyboard;
• cancellable and deferrable mutation requests that keep the source unchanged until host persistence succeeds;
• reconciliation of external collection and text changes by stable key;
• Light, Dark, and High Contrast resources plus semantic UI Automation children.

TimelineView

TimelineView is a continuous, interactive activity timeline:

• data-derived time bounds with an explicit, hard-range override;
• horizontal or vertical time, with automatic lanes for overlapping intervals;
• one-owner calendar-day paging with synchronized 1–31-day columns;
• time-only zoom, configurable presets, Fit, Now, and date/time navigation;
• templated activity content, selection, invocation, and context actions;
• UTC-based duration geometry with localized, time-zone-aware ruler labels;
• bounded item realization, keyboard/UI Automation, and Fluent theme support.

See the TimelineView guide for data, navigation, input, templating, and large-source examples.

Install

dotnet add package ArcadioG.Ananke

The package targets net10.0-windows10.0.19041.0 and carries transitive Windows App SDK and Win2D dependencies. WinUI XBF/PRI assets are copied by the package's buildTransitive target.

Use

RadarControl

<Window
    xmlns:ananke="using:Ananke.Controls">
  <ananke:RadarControl x:Name="Radar"
                       IsEditable="True"
                       IsSeriesActivationEnabled="True" />
</Window>

Radar.Axes.Add(new RadarAxis
{
    Key = "speed", Label = "Speed", Minimum = 0, Maximum = 100,
    SmallChange = 1, LargeChange = 10
});

var baseline = new RadarSeries { Key = "baseline", Name = "Baseline" };
baseline.Values.Add(new RadarValue("speed", 72));
// Add one value for every axis before the next dispatcher render pass.
Radar.Series.Add(baseline);
Radar.ActiveSeriesKey = baseline.Key;

Radar.EditUpdating += (_, e) =>
{
    // Host policy can coerce one value or the complete proposed vector.
    e.ProposedValues[e.AxisKey] = Math.Round(e.RawProposedValue);
};

The model uses axis identity rather than array position. Values must be finite and complete; keys must be unique; every range must satisfy Minimum < Maximum. Call Validate() to synchronously validate a complete model.

The radar uses an opaque theme-aware surface by default. Its Win2D CanvasControl surface supports alpha composition with XAML content behind the radar. To opt into a transparent drawing surface:

Radar.Background = new SolidColorBrush(Colors.Transparent);
Radar.Appearance = new RadarAppearance
{
    SurfaceColor = Colors.Transparent
};

SurfaceColor accepts any alpha value. High Contrast mode always uses the system background color instead so radar content retains the expected contrast. Editing callouts use their own opaque semantic background, text, and border colors, so they remain readable even when the radar drawing surface is fully transparent.

Axis labels are positioned directionally outside the outer polygon and kept within the control bounds. RadarAppearance.LabelFontSize and the actual label strings participate in plot sizing; long and explicit multiline labels wrap by default.

Custom radar control templates must use a Win2D CanvasControl named PART_Surface, replacing the CanvasAnimatedControl used before 0.4.0. The standard template already includes this change.

EditableTagCollection

<Window
    xmlns:ananke="using:Ananke.Controls">
  <ananke:EditableTagCollection x:Name="Tags"
                                PlaceholderText="Add topic"
                                MutationRequested="Tags_MutationRequested" />
</Window>

Tags.Tags.Add(new EditableTag("roadmap", "Roadmap"));
Tags.Tags.Add(new EditableTag("research", "Customer research"));

private async void Tags_MutationRequested(
    object? sender,
    EditableTagMutationRequestedEventArgs e)
{
    var deferral = e.GetDeferral();
    try
    {
        await PersistTagMutationAsync(e);
        // Set e.Cancel for a policy rejection, or e.ErrorMessage when persistence fails.
    }
    finally
    {
        deferral.Complete();
    }
}

The built-in Tags collection is used unless ItemsSource is set. Editable external sources must implement writable, variable-size IList; every EditableTag.Key must be non-null and unique. Text is trimmed and validated before MutationRequested. The active source changes only after all deferrals complete and the request remains valid. Call Validate() to synchronously verify source and policy configuration.

Keyboard and automation

RadarControl

The UI Automation tree exposes radar → series → value nodes. Active editable values implement RangeValue; series implement selection and invocation.

EditableTagCollection

The UI Automation root is a list with ordered tag list-items and a final add button. Tags expose Invoke for direct editing and a named Remove child button, the inline editor exposes Value, and mutation status is announced through a polite live region.

Build and gallery

Requires Visual Studio 2026 with Windows development tools and .NET SDK 10.0.400.

dotnet restore Ananke.slnx
dotnet build Ananke.slnx -c Release --no-restore
dotnet test tests\Ananke.Tests\Ananke.Tests.csproj -c Release --no-build
dotnet restore samples\Ananke.Gallery\Ananke.Gallery.csproj -r win-x64
dotnet publish samples\Ananke.Gallery\Ananke.Gallery.csproj -c Debug -r win-x64 --self-contained --no-restore

Launch:

samples\Ananke.Gallery\bin\Debug\net10.0-windows10.0.19041.0\win-x64\publish\Ananke.Gallery.exe

The gallery is unpackaged and self-contained for reliable local deployment.

Package and release

dotnet pack src\Ananke\Ananke.csproj -c Release -o artifacts\packages

Pushing a v* tag runs build, tests, package inspection, artifact upload, GitHub Release creation, and NuGet trusted publishing via OIDC.

License

MIT