fix: ensure bounds vmaps as best as possible, more equinox errors, types for __eq__, _BoundsD/I, and _PositionD/I

[beckermr]

This PR fixes a few other things with the bounds classes, images and typing.

• ensure BoundsD/I vmaps as best as possible
• use equinox to raise errors in the image classes
• ensure all __eq__ methods return JAX boolean values except when no values from the class are ever traced (e.g., two static BoundsI classes, interpolants)
• docs
• implement _BoundsD/I
• implement _PositionD/I
• add tests
  • bool __eq__ API
  • bounds vmap
  • bounds set
  • bounds includes

closes #245
closes #237

[codspeed-hq]

Merging this PR will improve performance by 45.35%

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 12 improved benchmarks
❌ 1 (👁 1) regressed benchmark
✅ 23 untouched benchmarks

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
👁	Simulation	test_benchmark_invert_ab_noraise[run]	523 µs	803.1 µs	-34.88%
⚡	WallTime	test_benchmark_moffat_init[run]	80.3 µs	38.5 µs	×2.1
⚡	WallTime	test_benchmarks_lanczos_interp[xval-conserve_dc-run]	135.7 µs	91.3 µs	+48.57%
⚡	WallTime	test_benchmark_spergel_calcfluxrad[run]	217 µs	143.8 µs	+50.92%
⚡	WallTime	test_benchmark_gaussian_init[run]	7.3 µs	5.3 µs	+35.82%
⚡	WallTime	test_benchmarks_lanczos_interp[xval-no_conserve_dc-run]	125.1 µs	79.7 µs	+56.91%
⚡	WallTime	test_benchmark_interpimage_flux_frac[run]	502.5 µs	329.2 µs	+52.62%
⚡	WallTime	test_benchmarks_lanczos_interp[kval-conserve_dc-run]	56.9 µs	32 µs	+77.83%
⚡	WallTime	test_benchmark_rng_discard[run]	119.3 µs	85.9 µs	+38.79%
⚡	WallTime	test_benchmarks_lanczos_interp[kval-no_conserve_dc-run]	56.3 µs	32.1 µs	+75.4%
⚡	WallTime	test_benchmark_invert_ab_noraise[run]	135.8 µs	88.8 µs	+52.92%
⚡	WallTime	test_benchmark_spergel_kvalue[run]	14 ms	10.5 ms	+33.04%
⚡	WallTime	test_benchmark_spergel_init[run]	7.6 µs	5.1 µs	+48.12%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing bounds-fix-again-all-static (d5d20dd) with main (e2b1029)}

[beckermr]

OK @ismael-mendoza this one is ready for review. I hope this is the last major bit of work on these classes for a long time!