InventingAnimals.Ink.Localization 0.6.0

Ink

UI component library for Avalonia applications, supporting Desktop (Windows, Linux, macOS), Mobile (iOS, Android), and WASM.

Documentation | Live demo

What's included

Ink

InventingAnimals.Ink - UI components and theming for Avalonia applications. Documentation

• InkTheme with a built-in color palette, typography, and metric tokens
• Dark and light theme support out of the box

Ink.Platform

InventingAnimals.Ink.Platform - cross-platform service abstractions. Documentation

• IWindowService - opens a new window on Desktop/Mobile and a new browser tab on Web (always non-modal)
• ISettingsService / FileSettingsService - persistent key-value storage backed by a JSON file; trim and NativeAOT safe
• IRouter / InMemoryRouter - client-side navigation with full URL parsing (path, segments, query, fragment)

Ink.Platform.Browser

InventingAnimals.Ink.Platform.Browser - browser/WASM implementations of the platform services.

• LocalStorageSettingsService - settings backed by browser localStorage
• BrowserHistoryRouter - routing via the History API (pushState / popstate)

Ink.FontAwesome

InventingAnimals.Ink.FontAwesome - optional Font Awesome icon control and generated icon definitions for Ink applications.

• FontAwesomeIcon control with strongly typed Icon and Face properties
• Generated icon metadata in C# so applications do not allocate one object per icon definition
• Consumer applications provide the actual Font Awesome font files and configure the face-to-font-family mapping
• Separate package so applications only take the dependency when they want the icon set

Ink.Localization

InventingAnimals.Ink.Localization - client and server localization with no Avalonia dependency.

• ILocalizationService / LocalizationService - client-side string lookup backed by ResourceManager
• IApiLocalizationService / ApiLocalizationService - server-side variant with explicit CultureInfo per call
• Loc - static ambient accessor for use in ViewModels (Loc.Get("key"), Loc.Plural(...))
• CLDR plural rules via PluralSelector; trim and NativeAOT safe

Ink.Data

InventingAnimals.Ink.Data - shared query model for DataGrid with no Avalonia or database dependency. Documentation

• DataQuery with composable filter trees (FilterAnd, FilterOr, FilterNot, FilterCondition)
• FilterOp - extensible operators; built-in set covers equality, comparison, range, null, in/not-in, and string ops
• SortDescriptor, DataPage<T>, IDataSource<T>
• Full JSON round-trip via System.Text.Json; WASM-safe

Ink.DataGrid

InventingAnimals.Ink.DataGrid - DataGrid control for Avalonia applications. Documentation

• Columns and data source defined entirely in the view model - no XAML column configuration required
• DataGridModel<T> base class wires an IDataSource<T> to the grid; inherit it in your view model
• ListDataSource<T> in Ink.Data for in-memory collections; plug in any IDataSource<T> for remote or database-backed data

Ink.Data.EFCore

InventingAnimals.Ink.Data.EFCore - server-side EF Core query translator. Documentation

• EFCoreQueryTranslator<T> - translates DataQuery into IQueryable<T> filter, sort, and pagination
• Type-safe column registration via expressions (x => x.Name); unregistered fields throw UnauthorizedFieldException
• Extensible with custom operators via HandleOp

Installation

dotnet add package InventingAnimals.Ink

For platform services:

dotnet add package InventingAnimals.Ink.Platform
dotnet add package InventingAnimals.Ink.Platform.Browser  # WASM projects only
dotnet add package InventingAnimals.Ink.FontAwesome       # optional icon resources
dotnet add package InventingAnimals.Ink.Localization

Example:

using Avalonia.Media;
using Ink.FontAwesome;

FontAwesomeFontFamilies.ClassicSolid = new FontFamily("avares://MyApp/Assets/Font Awesome 7 Free-Solid-900.otf#Font Awesome 7 Free");
FontAwesomeFontFamilies.ClassicRegular = new FontFamily("avares://MyApp/Assets/Font Awesome 7 Free-Regular-400.otf#Font Awesome 7 Free");
FontAwesomeFontFamilies.Brands = new FontFamily("avares://MyApp/Assets/Font Awesome 7 Brands-Regular-400.otf#Font Awesome 7 Brands");

<Window
    xmlns="https://github.com/avaloniaui"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:fa="using:Ink.FontAwesome">

    <fa:FontAwesomeIcon
        Icon="{x:Static fa:Icon.RectanglePro}"
        Face="ClassicThin" />
</Window>

For the DataGrid control:

dotnet add package InventingAnimals.Ink.DataGrid
dotnet add package InventingAnimals.Ink.Data                 # included transitively, but useful standalone

For the server-side EF Core translator:

dotnet add package InventingAnimals.Ink.Data.EFCore          # server only

Contact

• Security isssues: security@inventing-animals.com
• Talk to us at: hello@inventing-animals.com

License

MIT

Acknowledgements

All third party licenses are listed in the THIRD-PARTY-NOTICES file.