fix(indexing): make every view executable with its source grid

[d-v-b]

🤖 AI text below 🤖

Make every LazyArray view executable through projection-aware readers. Previously, part.view.result() and unpartitioned reads bypassed planning and passed projection=None, so they failed with readers that needed chunk-local coordinates.

LazyArray.result() now plans every nonempty read and supplies both the source-global transform and a chunk projection. Partition views retain their source grid and reader, so they can be read, indexed, or repartitioned like any other view. Callers schedule part.view.result() and assemble its values at part.out_selection; partitions describe the plan and placement rather than providing a second execution API.

Remove the special partition-local source window. All views now use the full source shape as base_shape, including partition views. with_parts and with_parts_per_axis therefore consistently describe the source grid. unpartitioned() treats the source as one grid cell and still supplies a projection. Independently executed views plan for their own output domain; their placement transform need not equal the parent's placement transform. Prepared parent plans remain reusable through view.result(parts=parts).

Validation: 1,672 tests and doctests passed, no skips, including Dask and TensorStore coverage; strict documentation build passed; Pyright reports 0 errors and 90 warnings. Tests cover independent, nested, reversed, and repartitioned views, masked output, reader errors, scalars, repeated indices, and empty selections. Six reader-contract cases reproduced the missing-projection failure before the change. Applicable repository hooks passed; the unrelated root mypy hook was skipped (it previously reported four unused-ignore errors in files unchanged by this PR). Independent review found no actionable issues and validated 8,222 randomized nested and repartitioned reads.

[read-the-docs-community]

Documentation build overview

📚 zarr-indexing | 🛠️ Build #34555709 | 📁 Comparing ee341db against latest (ba883a5)

  🔍 Preview build  

24 files changed · ± 24 modified

± Modified

• index.html
• api/index.html
• design-notes/index.html
• guide/index.html
• ndsel/index.html
• api/boundary/index.html
• api/chunk_resolution/index.html
• api/domain/index.html
• api/errors/index.html
• api/grid/index.html
• and 14 more...

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.34%. Comparing base (0de6077) to head (ee341db).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4349   +/-   ##
=======================================
  Coverage   94.34%   94.34%           
=======================================
  Files          92       92           
  Lines       12935    12935           
=======================================
  Hits        12203    12203           
  Misses        732      732           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.