zarr-metadata 0.8.0 → 0.9.0

package/dist/data-type/uint16.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint16.d.ts","sourceRoot":"","sources":["../../src/data-type/uint16.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,eAAO,MAAM,MAAM,8CAAkC,CAAC"}

package/dist/data-type/uint16.js

@@ -0,0 +1,4 @@
+import { intDataType } from "./descriptor.js";
+/** The core `uint16` data type. */
+export const uint16 = intDataType("uint16", 0, 65535);
+//# sourceMappingURL=uint16.js.map

package/dist/data-type/uint16.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint16.js","sourceRoot":"","sources":["../../src/data-type/uint16.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,mCAAmC;AACnC,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/dist/data-type/uint32.d.ts

@@ -0,0 +1,3 @@
+/** The core `uint32` data type. */
+export declare const uint32: import("./descriptor.js").DataTypeDescriptor;
+//# sourceMappingURL=uint32.d.ts.map

package/dist/data-type/uint32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint32.d.ts","sourceRoot":"","sources":["../../src/data-type/uint32.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,eAAO,MAAM,MAAM,8CAAuC,CAAC"}

package/dist/data-type/uint32.js

@@ -0,0 +1,4 @@
+import { intDataType } from "./descriptor.js";
+/** The core `uint32` data type. */
+export const uint32 = intDataType("uint32", 0, 4294967295);
+//# sourceMappingURL=uint32.js.map

package/dist/data-type/uint32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint32.js","sourceRoot":"","sources":["../../src/data-type/uint32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,mCAAmC;AACnC,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC"}

package/dist/data-type/uint64.d.ts

@@ -0,0 +1,3 @@
+/** The core `uint64` data type. */
+export declare const uint64: import("./descriptor.js").DataTypeDescriptor;
+//# sourceMappingURL=uint64.d.ts.map

package/dist/data-type/uint64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint64.d.ts","sourceRoot":"","sources":["../../src/data-type/uint64.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,eAAO,MAAM,MAAM,8CAAiD,CAAC"}

package/dist/data-type/uint64.js

@@ -0,0 +1,4 @@
+import { intDataType } from "./descriptor.js";
+/** The core `uint64` data type. */
+export const uint64 = intDataType("uint64", 0, 18446744073709551615);
+//# sourceMappingURL=uint64.js.map

package/dist/data-type/uint64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint64.js","sourceRoot":"","sources":["../../src/data-type/uint64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,mCAAmC;AACnC,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/data-type/uint8.d.ts

@@ -0,0 +1,3 @@
+/** The core `uint8` data type. */
+export declare const uint8: import("./descriptor.js").DataTypeDescriptor;
+//# sourceMappingURL=uint8.d.ts.map

package/dist/data-type/uint8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint8.d.ts","sourceRoot":"","sources":["../../src/data-type/uint8.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,eAAO,MAAM,KAAK,8CAA+B,CAAC"}

package/dist/data-type/uint8.js

@@ -0,0 +1,4 @@
+import { intDataType } from "./descriptor.js";
+/** The core `uint8` data type. */
+export const uint8 = intDataType("uint8", 0, 255);
+//# sourceMappingURL=uint8.js.map

package/dist/data-type/uint8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uint8.js","sourceRoot":"","sources":["../../src/data-type/uint8.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,kCAAkC;AAClC,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC"}

package/dist/index.d.ts

@@ -7,9 +7,9 @@
  */
 export type { JSONValue, ZarrV3MetadataFieldJSON, ZarrV3NamedConfigJSON } from "./common.js";
 export { flattenTree, formatTree, isEmptyTree, MetadataValidationError, treeOf, type ErrorTree, type Issue, type IssueKind, type IssuePath, type ParseResult, type PathedIssue, } from "./errors.js";
-export type { ChunkGridVerdict, RectilinearChunkGridConfiguration, RectilinearDimSpec, RegularChunkGridConfiguration, } from "./chunk-grids.js";
-export type { ShardingIndexedCodecConfiguration, TransposeCodecConfiguration, } from "./codecs.js";
-export type { ComplexFillValue, FloatFillValue } from "./data-types.js";
+export type { ChunkGridVerdict, RectilinearChunkGridConfiguration, RectilinearDimSpec, RegularChunkGridConfiguration, } from "./chunk-grid/index.js";
+export type { ShardingIndexedCodecConfiguration, TransposeCodecConfiguration, } from "./codec/index.js";
+export type { BytesFillValue, ComplexFillValue, FloatFillValue, NumpyDatetime64Configuration, NumpyDatetime64FillValue, NumpyTimeUnit, RawBytesFillValue, StringFillValue, StructConfiguration, StructField, } from "./data-type/index.js";
 export * from "./schemas.js";
 export * from "./semantics.js";
 export type { StandardSchemaV1 } from "./standard-schema.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,SAAS,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,MAAM,EACN,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,iCAAiC,EACjC,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxE,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,SAAS,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,MAAM,EACN,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,iCAAiC,EACjC,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,MAAM,GAOP,MAAM,aAAa,CAAC;AAYrB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,MAAM,GAOP,MAAM,aAAa,CAAC;AAuBrB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/semantics.d.ts

@@ -1,10 +1,10 @@
 /**
  * Semantic (cross-field) validation for v3 array metadata: the
  * orchestrator. The rules themselves live with their content —
- * `chunk-grids.ts`, `codecs.ts`, and `data-types.ts` each hold the syntax
- * (types) and semantics (procedures) for the names this package
- * interprets, mirroring how the spec, the Python reference's type layout,
- * and the zarr-extensions registry are organized. This module only walks
+ * `chunk-grid/`, `codec/`, and `data-type/` hold one module per
+ * interpreted name (grids, codecs, data types), each with its syntax
+ * (types) and semantics (procedures), mirroring how the spec, the Python
+ * reference's type layout, and the zarr-extensions registry are organized. This module only walks
  * documents: extract shape, ask each content module for its verdicts,
  * thread the chunk-size context into codec pipelines, and descend into a
  * group's inline consolidated entries.

package/dist/semantics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAU,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAC;AA4BvE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAElE;AA0BD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAE7D"}
+{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAU,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAC;AAsBvE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAElE;AA0BD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAE7D"}

package/dist/semantics.js

@@ -1,10 +1,10 @@
 /**
  * Semantic (cross-field) validation for v3 array metadata: the
  * orchestrator. The rules themselves live with their content —
- * `chunk-grids.ts`, `codecs.ts`, and `data-types.ts` each hold the syntax
- * (types) and semantics (procedures) for the names this package
- * interprets, mirroring how the spec, the Python reference's type layout,
- * and the zarr-extensions registry are organized. This module only walks
+ * `chunk-grid/`, `codec/`, and `data-type/` hold one module per
+ * interpreted name (grids, codecs, data types), each with its syntax
+ * (types) and semantics (procedures), mirroring how the spec, the Python
+ * reference's type layout, and the zarr-extensions registry are organized. This module only walks
  * documents: extract shape, ask each content module for its verdicts,
  * thread the chunk-size context into codec pipelines, and descend into a
  * group's inline consolidated entries.
@@ -17,11 +17,11 @@
  * content-agnostic and corpus-governed; it never reads the content
  * modules.
  */
-import { chunkGridVerdict } from "./chunk-grids.js";
-import { pipelineIssues } from "./codecs.js";
-import { fillValueIssue } from "./data-types.js";
+import { chunkGridVerdict } from "./chunk-grid/index.js";
+import { pipelineIssues } from "./codec/index.js";
+import { dataTypeVerdict } from "./data-type/index.js";
 import { treeOf } from "./errors.js";
-import { fieldParts, isIntArray, isPlainObject } from "./guards.js";
+import { isIntArray, isPlainObject } from "./guards.js";
 function arraySemanticsIssues(value) {
     if (!isPlainObject(value) || value["node_type"] !== "array")
         return [];
@@ -29,13 +29,7 @@ function arraySemanticsIssues(value) {
     const shape = isIntArray(value["shape"]) ? value["shape"] : undefined;
     const grid = chunkGridVerdict(value["chunk_grid"], shape);
     issues.push(...grid.issues.map((issue) => ({ ...issue, path: ["chunk_grid", ...issue.path] })));
-    const dataType = fieldParts(value["data_type"]);
-    if (dataType !== undefined && "fill_value" in value) {
-        const message = fillValueIssue(dataType.name, value["fill_value"]);
-        if (message !== undefined) {
-            issues.push({ path: ["fill_value"], message, kind: "invalid_value" });
-        }
-    }
+    issues.push(...dataTypeVerdict(value["data_type"], "fill_value" in value, value["fill_value"]));
     const codecs = value["codecs"];
     if (Array.isArray(codecs)) {
         issues.push(...pipelineIssues(codecs, ["codecs"], shape?.length, grid.chunkSizes));

package/dist/semantics.js.map

@@ -1 +1 @@
-{"version":3,"file":"semantics.js","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"semantics.js","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zarr-metadata",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Spec-defined metadata types and validators for Zarr v2 and v3.",
   "license": "MIT",
   "type": "module",
@@ -34,7 +34,8 @@
     "clean": "rm -rf dist",
     "prepack": "npm run clean && npm run build",
     "test": "vitest run",
-    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json"
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
+    "docs": "typedoc"
   },
   "keywords": [
     "zarr",
@@ -45,6 +46,7 @@
     "@changesets/cli": "^3.0.1",
     "@standard-schema/spec": "^1.1.0",
     "@types/node": "^26.4.0",
+    "typedoc": "^0.28.20",
     "typescript": "^5.6.0",
     "vitest": "^3.0.0"
   }

package/src/chunk-grid/index.ts

@@ -0,0 +1,40 @@
+/**
+ * The chunk grids this package interprets, one module per grid, assembled
+ * into the dispatch the semantic layer uses. The structural document layer
+ * never reads these modules — extension points are uninterpreted there by
+ * spec design.
+ */
+import type { PathedIssue } from "../errors.js";
+import { fieldParts, isPlainObject } from "../guards.js";
+import { regularIssues } from "./regular.js";
+import { rectilinearIssues } from "./rectilinear.js";
+
+export type { RegularChunkGridConfiguration } from "./regular.js";
+export type { RectilinearChunkGridConfiguration, RectilinearDimSpec } from "./rectilinear.js";
+
+/** What interpreting a chunk grid yields for the rest of the semantic layer. */
+export interface ChunkGridVerdict {
+  /** Issues, pathed relative to the `chunk_grid` field. */
+  issues: PathedIssue[];
+  /**
+   * Distinct chunk lengths per dimension — the division context a
+   * sharding codec's inner chunks must satisfy — when derivable.
+   */
+  chunkSizes: number[][] | undefined;
+}
+
+/**
+ * Interpret a document's `chunk_grid` field: required members, cross-field
+ * rules against `shape`, and the division context for codec pipelines.
+ * Unrecognized grid names yield no issues and no context — the extension
+ * name space is open.
+ */
+export function chunkGridVerdict(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict {
+  if (!isPlainObject(rawGrid) && typeof rawGrid !== "string") {
+    return { issues: [], chunkSizes: undefined }; // structural layer's problem
+  }
+  const name = fieldParts(rawGrid)?.name;
+  if (name === "regular") return regularIssues(rawGrid, shape);
+  if (name === "rectilinear") return rectilinearIssues(rawGrid, shape);
+  return { issues: [], chunkSizes: undefined };
+}

package/src/{chunk-grids.ts → chunk-grid/rectilinear.ts}

@@ -1,17 +1,7 @@
-/**
- * The chunk grids this package interprets: syntax (configuration types) and
- * semantics (the spec's prose rules) for `regular` and `rectilinear`, in
- * one place per grid. The structural document layer never reads this
- * module — extension points are uninterpreted there by spec design.
- */
-
-import type { PathedIssue } from "./errors.js";
-import { configurationMissing, fieldParts, isIntArray, isPlainObject } from "./guards.js";
-
-/** Configuration of the core `regular` chunk grid. */
-export interface RegularChunkGridConfiguration {
-  chunk_shape: number[];
-}
+/** The zarr-extensions `rectilinear` chunk grid: syntax and semantics. */
+import type { PathedIssue } from "../errors.js";
+import { configurationMissing, fieldParts, isIntArray } from "../guards.js";
+import type { ChunkGridVerdict } from "./index.js";
 
 /**
  * One dimension's spec in a rectilinear grid: a bare integer (uniform
@@ -26,51 +16,7 @@ export interface RectilinearChunkGridConfiguration {
   chunk_shapes: RectilinearDimSpec[];
 }
 
-/** What interpreting a chunk grid yields for the rest of the semantic layer. */
-export interface ChunkGridVerdict {
-  /** Issues, pathed relative to the `chunk_grid` field. */
-  issues: PathedIssue[];
-  /**
-   * Distinct chunk lengths per dimension — the division context a
-   * sharding codec's inner chunks must satisfy — when derivable.
-   */
-  chunkSizes: number[][] | undefined;
-}
-
-function regularIssues(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict {
-  const issues: PathedIssue[] = [];
-  let chunkSizes: number[][] | undefined;
-  const configuration = fieldParts(rawGrid)?.configuration;
-  if (configurationMissing(rawGrid)) {
-    issues.push({
-      path: [],
-      message: '"regular" requires a configuration with "chunk_shape"',
-      kind: "missing_key",
-    });
-  } else if (configuration !== undefined && !Object.hasOwn(configuration, "chunk_shape")) {
-    issues.push({
-      path: ["configuration", "chunk_shape"],
-      message: "missing required key",
-      kind: "missing_key",
-    });
-  }
-  const configured = configuration?.["chunk_shape"];
-  if (isIntArray(configured)) {
-    if (shape !== undefined && configured.length !== shape.length) {
-      issues.push({
-        path: ["configuration", "chunk_shape"],
-        message: `expected one length per dimension of shape (${shape.length})`,
-        kind: "invalid_value",
-      });
-      // wrong arity: unusable as division context
-    } else {
-      chunkSizes = configured.map((length) => [length]);
-    }
-  }
-  return { issues, chunkSizes };
-}
-
-function rectilinearIssues(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict {
+export function rectilinearIssues(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict {
   const issues: PathedIssue[] = [];
   let chunkSizes: number[][] | undefined;
   const configuration = fieldParts(rawGrid)?.configuration;
@@ -140,19 +86,3 @@ function rectilinearIssues(rawGrid: unknown, shape: number[] | undefined): Chunk
   }
   return { issues, chunkSizes };
 }
-
-/**
- * Interpret a document's `chunk_grid` field: required members, cross-field
- * rules against `shape`, and the division context for codec pipelines.
- * Unrecognized grid names yield no issues and no context — the extension
- * name space is open.
- */
-export function chunkGridVerdict(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict {
-  if (!isPlainObject(rawGrid) && typeof rawGrid !== "string") {
-    return { issues: [], chunkSizes: undefined }; // structural layer's problem
-  }
-  const name = fieldParts(rawGrid)?.name;
-  if (name === "regular") return regularIssues(rawGrid, shape);
-  if (name === "rectilinear") return rectilinearIssues(rawGrid, shape);
-  return { issues: [], chunkSizes: undefined };
-}

package/src/chunk-grid/regular.ts

@@ -0,0 +1,42 @@
+/** The core `regular` chunk grid: syntax and semantics. */
+import type { PathedIssue } from "../errors.js";
+import { configurationMissing, fieldParts, isIntArray } from "../guards.js";
+import type { ChunkGridVerdict } from "./index.js";
+
+/** Configuration of the core `regular` chunk grid. */
+export interface RegularChunkGridConfiguration {
+  chunk_shape: number[];
+}
+
+export function regularIssues(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict {
+  const issues: PathedIssue[] = [];
+  let chunkSizes: number[][] | undefined;
+  const configuration = fieldParts(rawGrid)?.configuration;
+  if (configurationMissing(rawGrid)) {
+    issues.push({
+      path: [],
+      message: '"regular" requires a configuration with "chunk_shape"',
+      kind: "missing_key",
+    });
+  } else if (configuration !== undefined && !Object.hasOwn(configuration, "chunk_shape")) {
+    issues.push({
+      path: ["configuration", "chunk_shape"],
+      message: "missing required key",
+      kind: "missing_key",
+    });
+  }
+  const configured = configuration?.["chunk_shape"];
+  if (isIntArray(configured)) {
+    if (shape !== undefined && configured.length !== shape.length) {
+      issues.push({
+        path: ["configuration", "chunk_shape"],
+        message: `expected one length per dimension of shape (${shape.length})`,
+        kind: "invalid_value",
+      });
+      // wrong arity: unusable as division context
+    } else {
+      chunkSizes = configured.map((length) => [length]);
+    }
+  }
+  return { issues, chunkSizes };
+}

package/src/codec/index.ts

@@ -0,0 +1,76 @@
+/**
+ * The codecs this package interprets, one module per codec, plus the
+ * pipeline walker that threads dimensional context between codecs
+ * (mirroring zarr-python's chunk-spec threading): a valid transpose
+ * permutes the per-dimension chunk sizes for the codecs after it, and any
+ * codec this package cannot reason about — `reshape` may change a chunk's
+ * rank, and unknown codecs may do anything — invalidates the dimensional
+ * context for the rest of the pipeline instead of letting stale
+ * array-level facts produce false verdicts.
+ *
+ * Other codecs' required fields (blosc, gzip, zstd, ...) are deliberately
+ * NOT known here: they are registry-schema facts enforced by schema-driven
+ * tooling, and a second hardcoded source of truth would drift.
+ */
+import type { PathedIssue } from "../errors.js";
+import { configurationMissing, fieldParts, type Path } from "../guards.js";
+import { shardingIndexedIssues } from "./sharding-indexed.js";
+import { transposeIssues } from "./transpose.js";
+
+export type { ShardingIndexedCodecConfiguration } from "./sharding-indexed.js";
+export type { TransposeCodecConfiguration } from "./transpose.js";
+
+/** The dimensional facts threaded between the codecs of one pipeline. */
+export interface PipelineContext {
+  /** Array dimensionality at this point; undefined when unknowable. */
+  dims: number | undefined;
+  /**
+   * Distinct chunk lengths per dimension this pipeline may encode — what a
+   * sharding codec's inner chunks must divide. A regular grid contributes
+   * one size per dimension; a rectilinear grid may contribute several.
+   */
+  chunkSizes: number[][] | undefined;
+}
+
+/** The spent/unknowable context. */
+export const DROPPED: PipelineContext = { dims: undefined, chunkSizes: undefined };
+
+/** Walk one codec pipeline, threading the dimensional context. */
+export function pipelineIssues(
+  pipeline: unknown[],
+  path: Path,
+  initialDims: number | undefined,
+  initialChunkSizes: number[][] | undefined,
+): PathedIssue[] {
+  const issues: PathedIssue[] = [];
+  let context: PipelineContext = { dims: initialDims, chunkSizes: initialChunkSizes };
+  pipeline.forEach((entry, index) => {
+    const parts = fieldParts(entry);
+    if (parts === undefined) {
+      context = DROPPED; // structurally invalid entry: no further reasoning
+      return;
+    }
+    const configMissing = configurationMissing(entry);
+    if (parts.name === "transpose") {
+      const result = transposeIssues(parts.configuration, configMissing, path, index, context);
+      issues.push(...result.issues);
+      context = result.context;
+    } else if (parts.name === "sharding_indexed") {
+      const result = shardingIndexedIssues(
+        parts.configuration,
+        configMissing,
+        path,
+        index,
+        context,
+        pipelineIssues,
+      );
+      issues.push(...result.issues);
+      context = result.context;
+    } else {
+      // A codec this package cannot reason about: stale array-level facts
+      // must not judge the codecs after it.
+      context = DROPPED;
+    }
+  });
+  return issues;
+}

package/src/codec/sharding-indexed.ts

@@ -0,0 +1,113 @@
+/** The core `sharding_indexed` codec: syntax and semantics. */
+import type { PathedIssue } from "../errors.js";
+import { isIntArray, type Path } from "../guards.js";
+import { DROPPED, type PipelineContext } from "./index.js";
+
+/** Configuration of the core `sharding_indexed` codec. */
+export interface ShardingIndexedCodecConfiguration {
+  chunk_shape: number[];
+  codecs: unknown[];
+  index_codecs: unknown[];
+  index_location?: "start" | "end";
+}
+
+type Walk = (
+  pipeline: unknown[],
+  path: Path,
+  dims: number | undefined,
+  chunkSizes: number[][] | undefined,
+) => PathedIssue[];
+
+/**
+ * Judge one sharding entry: it requires `chunk_shape`, `codecs`, and
+ * `index_codecs`; its chunk_shape must match the array's dimensionality
+ * and evenly divide every chunk it shards. The inner pipeline is walked
+ * with the shard's own chunk context (`index_codecs` encode the shard
+ * index, whose shape differs — no dimensional context applies there), and
+ * the array -> bytes boundary spends the context for whatever follows.
+ */
+export function shardingIndexedIssues(
+  configuration: Record<string, unknown> | undefined,
+  configMissing: boolean,
+  path: Path,
+  index: number,
+  context: PipelineContext,
+  walk: Walk,
+): { issues: PathedIssue[]; context: PipelineContext } {
+  const issues: PathedIssue[] = [];
+  if (configMissing) {
+    issues.push({
+      path: [...path, index],
+      message:
+        '"sharding_indexed" requires a configuration with "chunk_shape", "codecs", and "index_codecs"',
+      kind: "missing_key",
+    });
+    return { issues, context: DROPPED };
+  }
+  if (configuration !== undefined) {
+    for (const key of ["chunk_shape", "codecs", "index_codecs"]) {
+      if (!Object.hasOwn(configuration, key)) {
+        issues.push({
+          path: [...path, index, "configuration", key],
+          message: "missing required key",
+          kind: "missing_key",
+        });
+      }
+    }
+  }
+  const chunkShape = configuration?.["chunk_shape"];
+  if (!isIntArray(chunkShape)) {
+    // Still walk a present inner pipeline (entries deserve their own
+    // verdicts) before the context becomes unknowable.
+    const inner = configuration?.["codecs"];
+    if (Array.isArray(inner)) {
+      issues.push(
+        ...walk(inner, [...path, index, "configuration", "codecs"], undefined, undefined),
+      );
+    }
+    return { issues, context: DROPPED };
+  }
+  const chunkShapePath = [...path, index, "configuration", "chunk_shape"];
+  if (context.dims !== undefined && chunkShape.length !== context.dims) {
+    issues.push({
+      path: chunkShapePath,
+      message: `expected one length per array dimension (${context.dims})`,
+      kind: "invalid_value",
+    });
+  } else if (
+    context.chunkSizes !== undefined &&
+    chunkShape.length === context.chunkSizes.length &&
+    chunkShape.every((length) => length > 0)
+  ) {
+    let violation: { axis: number; size: number } | undefined;
+    context.chunkSizes.forEach((sizes, axis) => {
+      if (violation !== undefined) return;
+      const bad = sizes.find((size) => size % (chunkShape[axis] as number) !== 0);
+      if (bad !== undefined) violation = { axis, size: bad };
+    });
+    if (violation !== undefined) {
+      const { axis, size } = violation;
+      const sizesNow = context.chunkSizes;
+      const uniform = sizesNow.every((sizes) => sizes.length === 1);
+      issues.push({
+        path: chunkShapePath,
+        message: uniform
+          ? `expected ${JSON.stringify(chunkShape)} to evenly divide the outer chunk shape ${JSON.stringify(sizesNow.map((sizes) => sizes[0]))}`
+          : `expected ${JSON.stringify(chunkShape)} to evenly divide every chunk size of the grid (dimension ${axis} has chunk size ${size})`,
+        kind: "invalid_value",
+      });
+    }
+  }
+  const inner = configuration?.["codecs"];
+  if (Array.isArray(inner)) {
+    issues.push(
+      ...walk(
+        inner,
+        [...path, index, "configuration", "codecs"],
+        chunkShape.length,
+        chunkShape.map((length) => [length]),
+      ),
+    );
+  }
+  return { issues, context: DROPPED };
+}