AGENTS

This repository hosts various libraries distributed as NuGet packages. Keep these links up to date so contributors and tools can easily locate them.

Only the .NET SDK 8.0 is available in the execution environment. Use this version when building or running tests.

Implementation Guidelines

All *.csproj files should enable nullable reference types with <Nullable>enable</Nullable>.
Implementations should be optimized for maximum performance even if that introduces some code duplication.
Consider applying attributes such as MethodImplOptions.AggressiveInlining or faster alternatives to common operations when appropriate. Another would be modulo "%" or division "/" operations, which could be often replaced with faster alternatives, possibly under specific conditions.

When running dotnet test, do not pass --no-build because that leads to missing assemblies, test failures without logs and other issues.
When running dotnet test specify the --framework argument matching the SDK available in the environment (currently net8.0). If you omit this parameter, the tests will fail running with no logs etc.
The tests run for a very long time, because there are 61_000+ unit tests for all the collections. Set timeout when running them to 15 mis.
All tests must use xUnit together with FluentAssertions.

Indent code using four spaces or a single tab per level.
Place one blank line after each closing curly brace of a code block, except when several closing braces appear sequentially.
Always use braces for if and else bodies.