fix: #40 - System.InvalidOperationException in Query.Despawn (thanks very much, Grogian!)

changes: Archetypes no longer GC themselves when being migrated (e.g. when bulk-removing or -adding components).

use World.GC() for now if you have large or many transient Archetypes (usually happens with relations where target entities are despawned, as it takes an astronomical amount of iterations before that specific archetype would ever contain entities again). Future releases will automatically GC in World Catchup or similar, but this first requires some additional attributes to avoid collecting overly eagerly and having to re-create many archetypes.

• New Feature: per-component filters, via Stream.Where(...))

var myStream = _world.Query<Vector3, int>().Stream();
var myStreamOver9000 = myStream.Where((in int i) => i > 9000);
var myStreamOver9000LeftOnly = myStreamOver9000.Where((in Vector3 v) => v.X < 0.0f);

• New Feature: binary packaged for .NET 8, .NET 9, and .NET 10 frameworks.

• Breaking Change: Streams as readonly record structs. (only marginally affects API, but does have implications for Subset/Exclude Filter states, which can only be set when creating a new Stream instance, e.g. via the with keyword)

• Breaking Change: Streams no longer inherit all the subset methods (e.g., a Stream<ComponentA, ComponentB> no longer possesses a For(ComponentAction<ComponentA>) action, the stream will always enumerate all component data. You can obtain a new Stream through the exposed Query field on an existing Stream.

• Fix: Isse #38, InvalidOperationException in Component.ToString()

• Fix: Double-Free in QueryBuilder lead to corruption of MaskPool.

• Improvement: reduced thread locks everywhere.

Full Changelog: 0.5.16-beta...0.6.0

FIXES #37: Wildcard Match Expressions didn't work in Stream Subset and Exclude filters.

IMPROVES: Slightly faster general case matching (doesn't construct an ImmutableSortedSet) for Stream Filters.

Experimental Feature: Include Portable Debug Information.

fennecs originally shipped with windows-only debug info. User dxman reported an issue and warnings with Debugging in Release configuration; and possibly the debug configuration's .pdb files were also not correctly included.

I opted to try a new build with the new .snupkg format to provide accompanying debug information to users of the nuget package, for all types of assemblies.

See also: Creating symbol packages (.snupkg)

What's Changed

• Fixed a bug that would arise from reading junk data off shared array buffers. by @Naalunth in #29

New Contributors

• @Naalunth made their first contribution in #29

Full Changelog: 0.5.13-beta...0.5.14-beta