SwiftCollections.FixedMathSharp 8.0.0

SwiftCollections

Specialized .NET collections for hot paths that need tighter control over storage, allocation, iteration, and spatial queries.

The BCL collections are excellent defaults. SwiftCollections is for the code where profiling says the default is no longer enough: simulation loops, games, spatial indexing, deterministic runtimes, and allocation-sensitive tooling.

Why SwiftCollections?

• Low-allocation lists, queues, stacks, hash tables, slot maps, ticket maps, packed sets, sparse sets, and sparse maps.
• Dense iteration and stable or generation-checked handles for entity-style workloads.
• BVH, spatial hash, and octree queries over System.Numerics volumes.
• Fixed-point query companions powered by FixedMathSharp.
• Explicit state-backed serialization, with Standard and Lean package variants.
• Explicit retained-reference cleanup at ownership boundaries, while preserving reusable capacity.
• Benchmarks and full reachable coverage enforced as part of the repository workflow.

Install

Choose one package family:

dotnet add package SwiftCollections

Or install a companion package when you need fixed-point query volumes. NuGet brings in the matching SwiftCollections and FixedMathSharp packages:

dotnet add package SwiftCollections.FixedMathSharp

Use the matching .Lean packages as a pair. Lean keeps the collection APIs but removes the MemoryPack runtime; it is useful when your application owns its serialization stack or wants the smaller dependency surface.

A quick taste

SwiftTicketMap<T> gives you stable slots with generation-checked handles that stop resolving after removal and slot reuse:

using System;
using SwiftCollections;

var actors = new SwiftTicketMap<string>();
SwiftTicket player = actors.Add("player");

if (actors.TryGet(player, out string actor))
{
    Console.WriteLine(actor);
}

actors.Remove(player);

For externally owned compact integer IDs, start with SwiftSparseSet or SwiftSparseMap<T>. For broad-phase queries, start with SwiftBVH<TKey>, SwiftSpatialHash<TKey>, or SwiftOctree<TKey>.

Shared logging and exception guards come from the independent Chronicler.Diagnostics package. See the migration guide for the updated imports and guard names.

Learn more

• Getting started

• Collections and clearing

• Spatial queries

• Library overview and container guide

• Core API reference

• Spatial query API

• Coverage report

• Contributing and local validation

Using Unity? The maintained SwiftCollections-Unity packages add Unity-serializable adapters, Bounds conversions, GameObject pooling, and FixedMathSharp integration.

Compatibility

The libraries target netstandard2.1 and net10.0. CI validates Standard and Lean builds on Windows and Linux.

Questions and discussion are welcome in the Discord community. SwiftCollections is available under the MIT License. See Support, the Code of Conduct, and Security for help and reporting guidance.