zarr-metadata 0.8.0 → 0.9.0

package/README.md

@@ -80,19 +80,23 @@ The structural validators check key presence, value shapes, and fixed
 literals without interpreting extension points, matching the Python
 package's layering. The semantic layer (`validateSemanticsV3` /
 `validateArraySemanticsV3`) is TS-only and sits on top, organized by
-content: `chunk-grids.ts`, `codecs.ts`, and `data-types.ts` each hold the
-syntax (configuration types) and semantics (required members, cross-field
-prose rules — grid arity and sums, transpose permutations, sharding
-divisibility, fill_value vs data type) for the names the package
-interprets, with `semantics.ts` as the document-walking orchestrator.
-Unrecognized names are skipped — the extension name space is open.
+content: `chunk-grid/`, `codec/`, and `data-type/` hold one module per
+interpreted name, each with its syntax (configuration and fill-value
+types) and semantics (required members, cross-field prose rules — grid
+arity and sums, transpose permutations, sharding divisibility, fill_value
+vs data type). Interpreted data types cover the core scalars, the `r<N>`
+raw-bits family, and the established zarr-extensions conventions —
+`string`, `bytes`, `numpy.datetime64`/`timedelta64`, and `struct` (whose
+fill is judged per field, recursively). `semantics.ts` is the
+document-walking orchestrator. Unrecognized names are skipped — the
+extension name space is open.
 
 Consumers include the
 [Zarr Metadata VS Code extension](https://github.com/d-v-b/vscode-zarr).
 
 ## How correctness is maintained
 
-The [conformance corpus](conformance/) is the contract with the Python
+The [conformance corpus](https://github.com/d-v-b/zarr-metadata.js/tree/main/conformance) is the contract with the Python
 reference implementation: shared JSON fixtures asserting the exact problem
 set (loc + kind) each document must produce. Both test suites run every
 case; a spec change updates the corpus first, turning both implementations

package/dist/chunk-grid/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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";
+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 declare function chunkGridVerdict(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict;
+//# sourceMappingURL=index.d.ts.map

package/dist/chunk-grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chunk-grid/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,YAAY,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE9F,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB;;;OAGG;IACH,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,gBAAgB,CAQhG"}

package/dist/chunk-grid/index.js

@@ -0,0 +1,21 @@
+import { fieldParts, isPlainObject } from "../guards.js";
+import { regularIssues } from "./regular.js";
+import { rectilinearIssues } from "./rectilinear.js";
+/**
+ * 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, shape) {
+    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 };
+}
+//# sourceMappingURL=index.js.map

package/dist/chunk-grid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chunk-grid/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAgBrD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,KAA2B;IAC5E,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3D,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,6BAA6B;IAC7E,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACvC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7D,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAC/C,CAAC"}

package/dist/chunk-grid/rectilinear.d.ts

@@ -0,0 +1,14 @@
+import type { ChunkGridVerdict } from "./index.js";
+/**
+ * One dimension's spec in a rectilinear grid: a bare integer (uniform
+ * shorthand, no sum constraint) or a list of chunk sizes and
+ * `[size, count]` run-length pairs that must sum to the dimension length.
+ */
+export type RectilinearDimSpec = number | Array<number | [number, number]>;
+/** Configuration of the zarr-extensions `rectilinear` chunk grid. */
+export interface RectilinearChunkGridConfiguration {
+    kind: "inline";
+    chunk_shapes: RectilinearDimSpec[];
+}
+export declare function rectilinearIssues(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict;
+//# sourceMappingURL=rectilinear.d.ts.map

package/dist/chunk-grid/rectilinear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rectilinear.d.ts","sourceRoot":"","sources":["../../src/chunk-grid/rectilinear.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3E,qEAAqE;AACrE,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,gBAAgB,CAqEjG"}

package/dist/{chunk-grids.js → chunk-grid/rectilinear.js}

@@ -1,45 +1,5 @@
-/**
- * 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 { configurationMissing, fieldParts, isIntArray, isPlainObject } from "./guards.js";
-function regularIssues(rawGrid, shape) {
-    const issues = [];
-    let chunkSizes;
-    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, shape) {
+import { configurationMissing, fieldParts } from "../guards.js";
+export function rectilinearIssues(rawGrid, shape) {
     const issues = [];
     let chunkSizes;
     const configuration = fieldParts(rawGrid)?.configuration;
@@ -113,21 +73,4 @@ function rectilinearIssues(rawGrid, shape) {
     }
     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, shape) {
-    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 };
-}
-//# sourceMappingURL=chunk-grids.js.map
+//# sourceMappingURL=rectilinear.js.map

package/dist/chunk-grid/rectilinear.js.map

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

package/dist/chunk-grid/regular.d.ts

@@ -0,0 +1,7 @@
+import type { ChunkGridVerdict } from "./index.js";
+/** Configuration of the core `regular` chunk grid. */
+export interface RegularChunkGridConfiguration {
+    chunk_shape: number[];
+}
+export declare function regularIssues(rawGrid: unknown, shape: number[] | undefined): ChunkGridVerdict;
+//# sourceMappingURL=regular.d.ts.map

package/dist/chunk-grid/regular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regular.d.ts","sourceRoot":"","sources":["../../src/chunk-grid/regular.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,sDAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,gBAAgB,CA+B7F"}

package/dist/chunk-grid/regular.js

@@ -0,0 +1,36 @@
+import { configurationMissing, fieldParts, isIntArray } from "../guards.js";
+export function regularIssues(rawGrid, shape) {
+    const issues = [];
+    let chunkSizes;
+    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 };
+}
+//# sourceMappingURL=regular.js.map

package/dist/chunk-grid/regular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regular.js","sourceRoot":"","sources":["../../src/chunk-grid/regular.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ5E,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,KAA2B;IACzE,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,UAAkC,CAAC;IACvC,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACzD,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,uDAAuD;YAChE,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC;QACvF,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC;YACtC,OAAO,EAAE,sBAAsB;YAC/B,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC;gBACtC,OAAO,EAAE,+CAA+C,KAAK,CAAC,MAAM,GAAG;gBACvE,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;YACH,4CAA4C;QAC9C,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC"}

package/dist/codec/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 { type Path } from "../guards.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 declare const DROPPED: PipelineContext;
+/** Walk one codec pipeline, threading the dimensional context. */
+export declare function pipelineIssues(pipeline: unknown[], path: Path, initialDims: number | undefined, initialChunkSizes: number[][] | undefined): PathedIssue[];
+//# sourceMappingURL=index.d.ts.map

package/dist/codec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codec/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAoC,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAI3E,YAAY,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC/E,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElE,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC;CACpC;AAED,oCAAoC;AACpC,eAAO,MAAM,OAAO,EAAE,eAA4D,CAAC;AAEnF,kEAAkE;AAClE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,iBAAiB,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,GACxC,WAAW,EAAE,CAgCf"}

package/dist/codec/index.js

@@ -0,0 +1,35 @@
+import { configurationMissing, fieldParts } from "../guards.js";
+import { shardingIndexedIssues } from "./sharding-indexed.js";
+import { transposeIssues } from "./transpose.js";
+/** The spent/unknowable context. */
+export const DROPPED = { dims: undefined, chunkSizes: undefined };
+/** Walk one codec pipeline, threading the dimensional context. */
+export function pipelineIssues(pipeline, path, initialDims, initialChunkSizes) {
+    const issues = [];
+    let context = { 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;
+}
+//# sourceMappingURL=index.js.map

package/dist/codec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codec/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAa,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAiBjD,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAoB,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAEnF,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAC5B,QAAmB,EACnB,IAAU,EACV,WAA+B,EAC/B,iBAAyC;IAEzC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAoB,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IACpF,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,GAAG,OAAO,CAAC,CAAC,mDAAmD;YACtE,OAAO;QACT,CAAC;QACD,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACzF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,qBAAqB,CAClC,KAAK,CAAC,aAAa,EACnB,aAAa,EACb,IAAI,EACJ,KAAK,EACL,OAAO,EACP,cAAc,CACf,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,oEAAoE;YACpE,sCAAsC;YACtC,OAAO,GAAG,OAAO,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/codec/sharding-indexed.d.ts

@@ -0,0 +1,26 @@
+/** The core `sharding_indexed` codec: syntax and semantics. */
+import type { PathedIssue } from "../errors.js";
+import { type Path } from "../guards.js";
+import { 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 declare function shardingIndexedIssues(configuration: Record<string, unknown> | undefined, configMissing: boolean, path: Path, index: number, context: PipelineContext, walk: Walk): {
+    issues: PathedIssue[];
+    context: PipelineContext;
+};
+export {};
+//# sourceMappingURL=sharding-indexed.d.ts.map

package/dist/codec/sharding-indexed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharding-indexed.d.ts","sourceRoot":"","sources":["../../src/codec/sharding-indexed.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3D,0DAA0D;AAC1D,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CAClC;AAED,KAAK,IAAI,GAAG,CACV,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,SAAS,KAC/B,WAAW,EAAE,CAAC;AAEnB;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAClD,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,IAAI,GACT;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CA6ErD"}

package/dist/codec/sharding-indexed.js

@@ -0,0 +1,80 @@
+import { isIntArray } from "../guards.js";
+import { DROPPED } from "./index.js";
+/**
+ * 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, configMissing, path, index, context, walk) {
+    const issues = [];
+    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;
+        context.chunkSizes.forEach((sizes, axis) => {
+            if (violation !== undefined)
+                return;
+            const bad = sizes.find((size) => size % chunkShape[axis] !== 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 };
+}
+//# sourceMappingURL=sharding-indexed.js.map

package/dist/codec/sharding-indexed.js.map

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

package/dist/codec/transpose.d.ts

@@ -0,0 +1,19 @@
+/** The core `transpose` codec: syntax and semantics. */
+import type { PathedIssue } from "../errors.js";
+import { type Path } from "../guards.js";
+import { type PipelineContext } from "./index.js";
+/** Configuration of the core `transpose` codec. */
+export interface TransposeCodecConfiguration {
+    order: number[];
+}
+/**
+ * Judge one transpose entry: it requires a configuration with `order`,
+ * which must be a permutation with one entry per array dimension. A sound
+ * transpose permutes the context's chunk sizes; an unsound one makes the
+ * downstream context unknowable.
+ */
+export declare function transposeIssues(configuration: Record<string, unknown> | undefined, configMissing: boolean, path: Path, index: number, context: PipelineContext): {
+    issues: PathedIssue[];
+    context: PipelineContext;
+};
+//# sourceMappingURL=transpose.d.ts.map

package/dist/codec/transpose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpose.d.ts","sourceRoot":"","sources":["../../src/codec/transpose.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3D,mDAAmD;AACnD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAClD,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,GACvB;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAoDrD"}

package/dist/codec/transpose.js

@@ -0,0 +1,66 @@
+import { isIntArray } from "../guards.js";
+import { DROPPED } from "./index.js";
+function isPermutation(order) {
+    const seen = new Set(order);
+    return seen.size === order.length && order.every((entry) => entry >= 0 && entry < order.length);
+}
+/**
+ * Judge one transpose entry: it requires a configuration with `order`,
+ * which must be a permutation with one entry per array dimension. A sound
+ * transpose permutes the context's chunk sizes; an unsound one makes the
+ * downstream context unknowable.
+ */
+export function transposeIssues(configuration, configMissing, path, index, context) {
+    const issues = [];
+    if (configMissing) {
+        issues.push({
+            path: [...path, index],
+            message: '"transpose" requires a configuration with "order"',
+            kind: "missing_key",
+        });
+        return { issues, context: DROPPED };
+    }
+    if (configuration !== undefined && !Object.hasOwn(configuration, "order")) {
+        issues.push({
+            path: [...path, index, "configuration", "order"],
+            message: "missing required key",
+            kind: "missing_key",
+        });
+        return { issues, context: DROPPED };
+    }
+    const order = configuration?.["order"];
+    if (!isIntArray(order)) {
+        return { issues, context: DROPPED }; // shape errors are the schema layer's
+    }
+    const orderPath = [...path, index, "configuration", "order"];
+    let sound = true;
+    if (!isPermutation(order)) {
+        sound = false;
+        issues.push({
+            path: orderPath,
+            message: `expected a permutation of the integers 0..${order.length - 1}`,
+            kind: "invalid_value",
+        });
+    }
+    if (context.dims !== undefined && order.length !== context.dims) {
+        sound = false;
+        issues.push({
+            path: orderPath,
+            message: `expected one entry per array dimension (${context.dims})`,
+            kind: "invalid_value",
+        });
+    }
+    if (!sound)
+        return { issues, context: DROPPED };
+    const sizes = context.chunkSizes;
+    return {
+        issues,
+        context: {
+            dims: context.dims,
+            chunkSizes: sizes !== undefined && order.length === sizes.length
+                ? order.map((axis) => sizes[axis])
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=transpose.js.map

package/dist/codec/transpose.js.map

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

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

@@ -0,0 +1,4 @@
+import { type DataTypeDescriptor } from "./descriptor.js";
+/** The core `bool` data type. */
+export declare const bool: DataTypeDescriptor;
+//# sourceMappingURL=bool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bool.d.ts","sourceRoot":"","sources":["../../src/data-type/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,iCAAiC;AACjC,eAAO,MAAM,IAAI,EAAE,kBAIlB,CAAC"}

package/dist/data-type/bool.js

@@ -0,0 +1,7 @@
+import { named, simple } from "./descriptor.js";
+/** The core `bool` data type. */
+export const bool = {
+    matches: named("bool"),
+    fillIssues: (fill) => typeof fill === "boolean" ? [] : simple('expected a boolean fill value for data type "bool"'),
+};
+//# sourceMappingURL=bool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bool.js","sourceRoot":"","sources":["../../src/data-type/bool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAEzE,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAuB;IACtC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;IACtB,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CACnB,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,oDAAoD,CAAC;CAChG,CAAC"}

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

@@ -0,0 +1,11 @@
+import { type DataTypeDescriptor } from "./descriptor.js";
+/**
+ * Fill value of the `bytes` data type: an array of integers in `[0, 255]`
+ * (one per byte) or a standard-alphabet base64 string.
+ */
+export type BytesFillValue = number[] | string;
+/** Whether `value` is standard-alphabet base64 (padded length a multiple of 4). */
+export declare function isBase64(value: string): boolean;
+/** The zarr-extensions `bytes` data type (variable-length raw bytes). */
+export declare const bytes: DataTypeDescriptor;
+//# sourceMappingURL=bytes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../src/data-type/bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;AAI/C,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,yEAAyE;AACzE,eAAO,MAAM,KAAK,EAAE,kBASnB,CAAC"}

package/dist/data-type/bytes.js

@@ -0,0 +1,18 @@
+import { isByteArray, named, simple } from "./descriptor.js";
+const BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
+/** Whether `value` is standard-alphabet base64 (padded length a multiple of 4). */
+export function isBase64(value) {
+    return value.length % 4 === 0 && BASE64.test(value);
+}
+/** The zarr-extensions `bytes` data type (variable-length raw bytes). */
+export const bytes = {
+    matches: named("bytes"),
+    fillIssues: (fill) => {
+        if (isByteArray(fill))
+            return [];
+        if (typeof fill === "string" && isBase64(fill))
+            return [];
+        return simple('expected an array of integers in [0, 255] or a base64 string for data type "bytes"');
+    },
+};
+//# sourceMappingURL=bytes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../src/data-type/bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAQtF,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,KAAK,GAAuB;IACvC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,IAAI,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1D,OAAO,MAAM,CACX,oFAAoF,CACrF,CAAC;IACJ,CAAC;CACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex128.d.ts","sourceRoot":"","sources":["../../src/data-type/complex128.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,eAAO,MAAM,UAAU,8CAAoC,CAAC"}

package/dist/data-type/complex128.js

@@ -0,0 +1,4 @@
+import { complexDataType } from "./descriptor.js";
+/** The core `complex128` data type (components are float64). */
+export const complex128 = complexDataType("complex128", 16);
+//# sourceMappingURL=complex128.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex128.js","sourceRoot":"","sources":["../../src/data-type/complex128.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC"}