jas88 / TypeGuesser / 19195662511

push

github

Feature/zero alloc thread safe v2 (#1)

- Fork to jas88/TypeGuesser for ongoing maintenance
- Remove HIC. prefix since that's restricted on Nuget.org
- Add thread-safety and enhanced high-throughput API

<!-- RECURSEML_SUMMARY:START -->
## High-level PR Summary

This PR introduces **TypeGuesser v2.0**, a major architectural upgrade
that adds **zero-allocation performance** for hard-typed values
(achieving 18-30× speedups), **thread-safety with internal locking**,
and **object pooling** for reduced GC pressure. The implementation uses
`Math.Log10` for allocation-free integer digit counting, `SqlDecimal`
structs for decimal precision extraction, and introduces a new advanced
API (`StackTypeAccumulator`) for ultra-high-performance scenarios. The
project has been forked to `jas88/TypeGuesser`, removes the `HIC.` NuGet
prefix, upgrades to .NET 9.0, implements centralized package management,
and adds comprehensive benchmarking infrastructure with detailed
performance documentation. **Full backward compatibility** is maintained
with v1.x while providing automatic optimizations when passing typed
values.


⏱️ Estimated Review Time: 3+ hours

<details>
<summary>💡 Review Order Suggestion</summary>

| Order | File Path |
|-------|-----------|
| 1 | `MIGRATION-V2.md` |
| 2 | `README.md` |
| 3 | `CHANGELOG.md` |
| 4 | `Directory.Packages.props` |
| 5 | `Directory.Build.props` |
| 6 | `global.json` |
| 7 | `TypeGuesser/TypeGuesser.csproj` |
| 8 | `TypeGuesser/TypeGuessResult.cs` |
| 9 | `TypeGuesser/PooledBuilder.cs` |
| 10 | `TypeGuesser/TypeGuesserBuilderPool.cs` |
| 11 | `TypeGuesser/Advanced/StackTypeAccumulator.cs` |
| 12 | `TypeGuesser/Advanced/ZeroAlloc.cs` |
| 13 | `TypeGuesser/Guesser.cs` |
| 14 | `TypeGuesser/PooledBuilderExample.cs` |
| 15 | `Tests/Tests.csproj` |
| 16 | `Tests/Advanced/StackTypeAccumulatorTests.cs` |
| 17 | `Tests/Advanced/ZeroAllocTests.cs` |
| 18 | `benchmarks/TypeGuesser.Benchmarks.csproj` |
| 19 | `benchmarks/Program.cs` |
| 20 | `b... (continued)

351 of 484 branches covered (72.52%)

Branch coverage included in aggregate %.

471 of 630 new or added lines in 7 files covered. (74.76%)

994 of 1325 relevant lines covered (75.02%)

202275.74 hits per line