refactor(api): list create's parameters on empty, zeros, ones and full

[d-v-b]

🤖 AI text below 🤖

zarr.empty, zeros, ones and full, their zarr.api.asynchronous versions, and Group/AsyncGroup empty, zeros, ones and full now list their parameters instead of taking **kwargs. The parameters are those of zarr.create. The group methods do not take store, path or storage_options, which the group supplies. An unknown keyword now raises a TypeError naming the function called. Passing data to these functions is deprecated; it fills the new array with data instead of the value the function is named for. To create an array from existing data, use zarr.create_array(data=...). Passing mode to the group methods is deprecated, because it never had an effect there.

This is the second step of replacing **kwargs in the array-creation helpers with explicit parameters. The *_like functions and open_array/open_like follow in separate PRs.

• The signatures are identical to create's, parameter for parameter, including the seven parameters that create accepts but does not implement (synchronizer, chunk_store, cache_metadata, cache_attrs, object_codec, read_only, meta_array). They are still forwarded and still warn in create. Removing them is left to the deprecation sweep, so it applies to create and the helpers together.
• zeros/ones do not take fill_value, which is already a TypeError today. full keeps fill_value as its second positional parameter.
• The group methods take zarr_format as a named parameter and check it against the group, replacing the kwargs.pop("zarr_format", None) calls added in fix(group): create group helper arrays in the group's zarr format #4412. storage_options was already rejected for arrays in a group (make_store_path raises for a StorePath); it is now a TypeError at the call.
• Docstrings document shape, fill_value, name, zarr_format and the deprecated parameters, and refer to create for the rest.
• Tests:
  • The signatures are compared with create's, so the helpers cannot drift from it.
  • Every argument is checked to reach create unchanged at each layer (async, sync, AsyncGroup, Group), using a recording stand-in.
  • There is one test for each of: the data deprecation, the group mode deprecation, and unknown keywords (including store/path on the group methods).
  • The agent checked that the tests fail when a forwarded argument is dropped, a warning is removed, or **kwargs is restored.

Notes

• This builds on fix(group): create group helper arrays in the group's zarr format #4412, which changes the same group methods, and contains its commits. Until fix(group): create group helper arrays in the group's zarr format #4412 merges, the diff here includes it. Review only the last commit, or merge fix(group): create group helper arrays in the group's zarr format #4412 first.
• It does not depend on feat(api): declare mode and data on create #4455. The helpers pass mode and data to create, which accepts them on main through **kwargs and, after feat(api): declare mode and data on create #4455, as named parameters. The signature test accepts both.
• The group *_like methods still pop zarr_format from **kwargs; they are part of the *_like PR.

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.49%. Comparing base (083adfc) to head (48389b0).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4457      +/-   ##
==========================================
+ Coverage   94.46%   94.49%   +0.02%     
==========================================
  Files          93       93              
  Lines       13233    13267      +34     
==========================================
+ Hits        12501    12536      +35     
+ Misses        732      731       -1     

Files with missing lines	Coverage Δ
src/zarr/api/asynchronous.py	96.55% <100.00%> (+0.24%)	⬆️
src/zarr/api/synchronous.py	94.36% <100.00%> (+1.40%)	⬆️
src/zarr/core/group.py	95.67% <100.00%> (+0.06%)	⬆️

🚀 New features to boost your workflow:

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