zarr-metadata 0.7.0 → 0.9.0

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

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

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/guards.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared value guards for the content modules (chunk grids, codecs, data
+ * types) and the semantics orchestrator. The structural document layer
+ * (validation.ts) keeps its own copies deliberately: it is the
+ * corpus-governed layer and stays self-contained.
+ */
+export type Path = ReadonlyArray<string | number>;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function isIntArray(value: unknown): value is number[];
+/** The `{name, configuration}` of a metadata field, when extractable. */
+export declare function fieldParts(field: unknown): {
+    name: string;
+    configuration: Record<string, unknown> | undefined;
+} | undefined;
+/**
+ * Whether a metadata field genuinely lacks a `configuration` member (a
+ * malformed one — `configuration: 5` — is the structural layer's
+ * complaint, not the semantic layer's).
+ */
+export declare function configurationMissing(field: unknown): boolean;
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAElD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAM5D;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAUlF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D"}

package/dist/guards.js

@@ -0,0 +1,39 @@
+/**
+ * Shared value guards for the content modules (chunk grids, codecs, data
+ * types) and the semantics orchestrator. The structural document layer
+ * (validation.ts) keeps its own copies deliberately: it is the
+ * corpus-governed layer and stays self-contained.
+ */
+export function isPlainObject(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === null || proto === Object.prototype;
+}
+export function isIntArray(value) {
+    return (Array.isArray(value) &&
+        Object.keys(value).length === value.length &&
+        value.every((item) => Number.isInteger(item)));
+}
+/** The `{name, configuration}` of a metadata field, when extractable. */
+export function fieldParts(field) {
+    if (typeof field === "string")
+        return { name: field, configuration: undefined };
+    if (isPlainObject(field) && typeof field["name"] === "string") {
+        const configuration = field["configuration"];
+        return {
+            name: field["name"],
+            configuration: isPlainObject(configuration) ? configuration : undefined,
+        };
+    }
+    return undefined;
+}
+/**
+ * Whether a metadata field genuinely lacks a `configuration` member (a
+ * malformed one — `configuration: 5` — is the structural layer's
+ * complaint, not the semantic layer's).
+ */
+export function configurationMissing(field) {
+    return (typeof field === "string" || (isPlainObject(field) && !Object.hasOwn(field, "configuration")));
+}
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtF,MAAM,KAAK,GAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAC1C,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CACxB,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IAChF,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC9D,MAAM,aAAa,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7C,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;SACxE,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAC9F,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -7,6 +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-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,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;AACrB,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,49 +1,21 @@
 /**
- * Semantic (cross-field) validation for v3 array metadata.
+ * Semantic (cross-field) validation for v3 array metadata: the
+ * orchestrator. The rules themselves live with their content —
+ * `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.
  *
- * The structural validators never interpret what an extension point names;
- * this module deliberately interprets a small set of WELL-KNOWN core
- * extension points to enforce the cross-field rules the specs state in
- * prose:
- *
- * - the `regular` chunk grid REQUIRES a configuration with `chunk_shape`,
- *   which has one length per dimension of `shape`;
- * - the `rectilinear` chunk grid requires a configuration with `kind` and
- *   `chunk_shapes`; `chunk_shapes` has one entry per dimension, and each
- *   explicit chunk list (integers and `[size, count]` run-length pairs)
- *   sums exactly to that dimension's length (the bare-integer uniform
- *   shorthand carries no sum constraint, like the regular grid);
- * - a `transpose` codec requires a configuration with `order`, a
- *   permutation of `0..n-1` with one entry per array dimension;
- * - a `sharding_indexed` codec requires a configuration with
- *   `chunk_shape`, `codecs`, and `index_codecs`; its inner `chunk_shape`
- *   matches the array's
- *   dimensionality and evenly divides every chunk it shards — the grid's
- *   chunk at the top level (each distinct per-dimension size, for
- *   rectilinear grids), the parent shard's inner chunk when sharding
- *   nests;
- * - `fill_value` has a JSON shape permitted for the named core data type
- *   (booleans for `bool`, ranged integers for the int types, numbers /
- *   the "NaN"-family sentinels / width-checked "0x…" strings for the
- *   float types, two-element arrays for the complex types).
- *
- * Dimensional context is THREADED through codec pipelines rather than
- * assumed constant (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 layer 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.
- *
- * Required-configuration rules cover ONLY the names this layer interprets
- * (the two grids, transpose, sharding). Other extensions' required fields
- * are registry-schema facts — the editor's registry layer enforces them
- * from the vendored schemas, and duplicating that knowledge here as
- * hardcoded rules would drift. Unrecognized names are skipped everywhere —
- * the extension name space is open, and a rule that guessed would lie. This layer has no counterpart
+ * Unrecognized names are skipped everywhere — the extension name space is
+ * open, and a rule that guessed would lie. This layer has no counterpart
  * in the Python reference implementation (which stops at structure), so it
  * is covered by this package's own tests rather than the conformance
- * corpus.
+ * corpus. The structural document layer (validation.ts) stays
+ * content-agnostic and corpus-governed; it never reads the content
+ * modules.
  */
 import { type ErrorTree } from "./errors.js";
 /**

package/dist/semantics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAU,KAAK,SAAS,EAAoB,MAAM,aAAa,CAAC;AAiavE;;;;;;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"}