add shard_grid_shape, chunk_grid_shape

Co-authored-by: Bojidar Marinov <[email protected]>

Author: d-v-b

src/zarr/core/array.py

@@ -1192,7 +1192,31 @@ def cdata_shape(self) -> ChunkCoords:
         Tuple[int]
             The shape of the chunk grid for this array.
         """
-        return tuple(starmap(ceildiv, zip(self.shape, self.chunks, strict=False)))
+        return self.chunk_grid_shape
+
+    @property
+    def chunk_grid_shape(self) -> ChunkCoords:
+        """
+        The shape of the chunk grid for this array.
+
+        Returns
+        -------
+        Tuple[int]
+            The shape of the chunk grid for this array.
+        """
+        return tuple(starmap(ceildiv, zip(self.shape, self.chunks, strict=True)))
+
+    @property
+    def shard_grid_shape(self) -> ChunkCoords:
+        """
+        The shape of the shard grid for this array.
+
+        Returns
+        -------
+        Tuple[int]
+            The shape of the shard grid for this array.
+        """
+        return tuple(starmap(ceildiv, zip(self.shape, self.shards, strict=True)))
 
     @property
     def nchunks(self) -> int:
@@ -2198,10 +2222,25 @@ def compressors(self) -> tuple[numcodecs.abc.Codec, ...] | tuple[BytesBytesCodec
 
     @property
     def cdata_shape(self) -> ChunkCoords:
+        """
+        The shape of the chunk grid for this array. This property exists for backwards compatibility.
+        See :func:`chunk_grid_shape` for the preferred method.
+        """
+        return self._async_array.chunk_grid_shape
+
+    @property
+    def chunk_grid_shape(self) -> ChunkCoords:
         """
         The shape of the chunk grid for this array.
         """
-        return tuple(starmap(ceildiv, zip(self.shape, self.chunks, strict=False)))
+        return self._async_array.chunk_grid_shape
+
+    @property
+    def shard_grid_shape(self) -> ChunkCoords:
+        """
+        The shape of the shard grid for this array.
+        """
+        return self._async_array.shard_grid_shape
 
     @property
     def nchunks(self) -> int: