zarr-metadata 0.7.0 → 0.9.0

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"}

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

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

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

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

package/dist/data-type/complex64.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex64.js","sourceRoot":"","sources":["../../src/data-type/complex64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * The data type descriptor interface and the shared fill-value machinery
+ * the per-type modules build on. One module per supported data type;
+ * `index.ts` assembles them into the dispatch the semantic layer uses.
+ */
+import type { IssueKind, PathedIssue } from "../errors.js";
+/** Context handed to a descriptor's fill check. */
+export interface FillContext {
+    /** The data_type field's configuration, when present and an object. */
+    configuration: Record<string, unknown> | undefined;
+    /** Recursion depth (struct fields may nest structs). */
+    depth: number;
+    /**
+     * Recursive check for compound types: issues for `fill` judged against
+     * the data type named by `dataTypeField`, pathed relative to that fill.
+     */
+    fillIssuesFor(dataTypeField: unknown, fill: unknown, depth: number): PathedIssue[];
+}
+/** Everything the semantic layer knows about one data type. */
+export interface DataTypeDescriptor {
+    /** Whether this module owns the given `data_type` name. */
+    matches(name: string): boolean;
+    /** Required configuration members, when the type needs a configuration. */
+    requiredConfigKeys?: readonly string[];
+    /** Name-level validity beyond ownership (e.g. r<N>'s multiple-of-8 rule). */
+    nameIssue?(name: string): string | undefined;
+    /** Fill-value issues, pathed relative to the fill value itself. */
+    fillIssues(fill: unknown, name: string, context: FillContext): PathedIssue[];
+}
+export declare function issue(path: ReadonlyArray<string | number>, message: string, kind?: IssueKind): PathedIssue;
+/** A single unpathed issue — the common case for scalar types. */
+export declare function simple(message: string): PathedIssue[];
+export declare function named(matchName: string): (name: string) => boolean;
+/** A float fill value: a JSON number, a non-finite sentinel, or a hex string. */
+export type FloatFillValue = number | "NaN" | "Infinity" | "-Infinity" | string;
+/** A complex fill value: `[real, imaginary]`, each a float fill form. */
+export type ComplexFillValue = [FloatFillValue, FloatFillValue];
+export declare function isFloatFill(value: unknown, hexDigits: number): boolean;
+export declare function floatFillMessage(name: string, hexDigits: number): string;
+export declare function isByteArray(value: unknown): value is number[];
+export declare function intDataType(name: string, low: number, high: number): DataTypeDescriptor;
+export declare function floatDataType(name: string, hexDigits: number): DataTypeDescriptor;
+export declare function complexDataType(name: string, componentHexDigits: number): DataTypeDescriptor;
+//# sourceMappingURL=descriptor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/data-type/descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3D,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;CACpF;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,6EAA6E;IAC7E,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,mEAAmE;IACnE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;CAC9E;AAED,wBAAgB,KAAK,CACnB,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,SAA2B,GAChC,WAAW,CAEb;AAED,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAErD;AAED,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAElE;AAID,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhF,yEAAyE;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AAEhE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAKtE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAM7D;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAQvF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAMjF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,kBAAkB,CAe5F"}

package/dist/data-type/descriptor.js

@@ -0,0 +1,57 @@
+export function issue(path, message, kind = "invalid_value") {
+    return { path, message, kind };
+}
+/** A single unpathed issue — the common case for scalar types. */
+export function simple(message) {
+    return [issue([], message)];
+}
+export function named(matchName) {
+    return (name) => name === matchName;
+}
+export function isFloatFill(value, hexDigits) {
+    if (typeof value === "number")
+        return true;
+    if (typeof value !== "string")
+        return false;
+    if (value === "NaN" || value === "Infinity" || value === "-Infinity")
+        return true;
+    return new RegExp(`^0x[0-9a-fA-F]{${hexDigits}}$`).test(value);
+}
+export function floatFillMessage(name, hexDigits) {
+    return (`expected a number, "NaN", "Infinity", "-Infinity", or a ` +
+        `${hexDigits}-hex-digit "0x..." string for data type ${JSON.stringify(name)}`);
+}
+export function isByteArray(value) {
+    return (Array.isArray(value) &&
+        Object.keys(value).length === value.length &&
+        value.every((item) => Number.isInteger(item) && item >= 0 && item <= 255));
+}
+// --- per-family factories ---------------------------------------------------
+export function intDataType(name, low, high) {
+    return {
+        matches: named(name),
+        fillIssues: (fill) => Number.isInteger(fill) && fill >= low && fill <= high
+            ? []
+            : simple(`expected an integer in [${low}, ${high}] for data type ${JSON.stringify(name)}`),
+    };
+}
+export function floatDataType(name, hexDigits) {
+    return {
+        matches: named(name),
+        fillIssues: (fill) => isFloatFill(fill, hexDigits) ? [] : simple(floatFillMessage(name, hexDigits)),
+    };
+}
+export function complexDataType(name, componentHexDigits) {
+    return {
+        matches: named(name),
+        fillIssues: (fill) => {
+            const ok = Array.isArray(fill) &&
+                fill.length === 2 &&
+                fill.every((part) => isFloatFill(part, componentHexDigits));
+            return ok
+                ? []
+                : simple(`expected a two-element [real, imaginary] array for data type ${JSON.stringify(name)}`);
+        },
+    };
+}
+//# sourceMappingURL=descriptor.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"float16.d.ts","sourceRoot":"","sources":["../../src/data-type/float16.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,eAAO,MAAM,OAAO,8CAA8B,CAAC"}

package/dist/data-type/float16.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"float16.js","sourceRoot":"","sources":["../../src/data-type/float16.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"float32.d.ts","sourceRoot":"","sources":["../../src/data-type/float32.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,eAAO,MAAM,OAAO,8CAA8B,CAAC"}

package/dist/data-type/float32.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"float32.js","sourceRoot":"","sources":["../../src/data-type/float32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/data-type/float64.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"float64.js","sourceRoot":"","sources":["../../src/data-type/float64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * The data types this package interprets, one module per type, assembled
+ * into the dispatch the semantic layer uses: the core scalars, the r<N>
+ * raw-bits family, and the established zarr-extensions conventions
+ * (string, bytes, numpy.datetime64/timedelta64, struct). Unrecognized
+ * names yield no verdicts — the name space is open — and other types'
+ * required fields remain registry-schema facts.
+ */
+import type { PathedIssue } from "../errors.js";
+export type { ComplexFillValue, DataTypeDescriptor, FillContext, FloatFillValue, } from "./descriptor.js";
+export type { BytesFillValue } from "./bytes.js";
+export type { NumpyDatetime64Configuration, NumpyDatetime64FillValue, NumpyTimeUnit, } from "./numpy-datetime64.js";
+export type { RawBytesFillValue } from "./raw.js";
+export type { StringFillValue } from "./string.js";
+export type { StructConfiguration, StructField } from "./struct.js";
+/**
+ * Interpret a document's `data_type` field against its `fill_value`:
+ * name-level rules, required configuration members, and the fill's JSON
+ * shape (recursively, for struct). Issues are pathed from the document
+ * root (`data_type` / `fill_value`).
+ */
+export declare function dataTypeVerdict(rawField: unknown, fillPresent: boolean, fill: unknown): PathedIssue[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data-type/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAwBhD,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA+BpE;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,OAAO,EACpB,IAAI,EAAE,OAAO,GACZ,WAAW,EAAE,CAyCf"}

package/dist/data-type/index.js

@@ -0,0 +1,92 @@
+import { configurationMissing, fieldParts } from "../guards.js";
+import { bool } from "./bool.js";
+import { bytes } from "./bytes.js";
+import { complex64 } from "./complex64.js";
+import { complex128 } from "./complex128.js";
+import { issue } from "./descriptor.js";
+import { float16 } from "./float16.js";
+import { float32 } from "./float32.js";
+import { float64 } from "./float64.js";
+import { int8 } from "./int8.js";
+import { int16 } from "./int16.js";
+import { int32 } from "./int32.js";
+import { int64 } from "./int64.js";
+import { numpyDatetime64 } from "./numpy-datetime64.js";
+import { numpyTimedelta64 } from "./numpy-timedelta64.js";
+import { raw } from "./raw.js";
+import { string } from "./string.js";
+import { struct } from "./struct.js";
+import { uint8 } from "./uint8.js";
+import { uint16 } from "./uint16.js";
+import { uint32 } from "./uint32.js";
+import { uint64 } from "./uint64.js";
+const DESCRIPTORS = [
+    bool,
+    int8, int16, int32, int64,
+    uint8, uint16, uint32, uint64,
+    float16, float32, float64,
+    complex64, complex128,
+    raw,
+    string, bytes,
+    numpyDatetime64, numpyTimedelta64,
+    struct,
+];
+function descriptorFor(name) {
+    return DESCRIPTORS.find((descriptor) => descriptor.matches(name));
+}
+// struct fields may nest structs; matches the structural layer's cap.
+const MAX_FILL_DEPTH = 64;
+function fillIssuesFor(dataTypeField, fill, depth) {
+    if (depth >= MAX_FILL_DEPTH)
+        return [];
+    const parts = fieldParts(dataTypeField);
+    if (parts === undefined)
+        return [];
+    const descriptor = descriptorFor(parts.name);
+    if (descriptor === undefined)
+        return []; // unrecognized: no verdict
+    const context = { configuration: parts.configuration, depth, fillIssuesFor };
+    return descriptor.fillIssues(fill, parts.name, context);
+}
+/**
+ * Interpret a document's `data_type` field against its `fill_value`:
+ * name-level rules, required configuration members, and the fill's JSON
+ * shape (recursively, for struct). Issues are pathed from the document
+ * root (`data_type` / `fill_value`).
+ */
+export function dataTypeVerdict(rawField, fillPresent, fill) {
+    const parts = fieldParts(rawField);
+    if (parts === undefined)
+        return [];
+    const descriptor = descriptorFor(parts.name);
+    if (descriptor === undefined)
+        return [];
+    const issues = [];
+    const nameProblem = descriptor.nameIssue?.(parts.name);
+    if (nameProblem !== undefined) {
+        issues.push(issue(["data_type"], nameProblem));
+    }
+    const required = descriptor.requiredConfigKeys;
+    if (required !== undefined) {
+        if (configurationMissing(rawField)) {
+            issues.push(issue(["data_type"], `${JSON.stringify(parts.name)} requires a configuration with ${required
+                .map((key) => JSON.stringify(key))
+                .join(" and ")}`, "missing_key"));
+        }
+        else if (parts.configuration !== undefined) {
+            for (const key of required) {
+                if (!Object.hasOwn(parts.configuration, key)) {
+                    issues.push(issue(["data_type", "configuration", key], "missing required key", "missing_key"));
+                }
+            }
+        }
+    }
+    if (fillPresent) {
+        issues.push(...fillIssuesFor(rawField, fill, 0).map((inner) => ({
+            ...inner,
+            path: ["fill_value", ...inner.path],
+        })));
+    }
+    return issues;
+}
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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

package/dist/data-type/int16.js

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

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

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

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

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

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

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

package/dist/data-type/int32.js

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

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

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

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

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

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

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

package/dist/data-type/int64.js

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"int8.d.ts","sourceRoot":"","sources":["../../src/data-type/int8.ts"],"names":[],"mappings":"AAEA,iCAAiC;AACjC,eAAO,MAAM,IAAI,8CAAiC,CAAC"}

package/dist/data-type/int8.js

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

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

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

package/dist/data-type/numpy-datetime64.d.ts

@@ -0,0 +1,18 @@
+import { type DataTypeDescriptor } from "./descriptor.js";
+/** Time unit codes used by numpy.datetime64 / numpy.timedelta64. */
+export type NumpyTimeUnit = "Y" | "M" | "W" | "D" | "h" | "m" | "s" | "ms" | "us" | "μs" | "ns" | "ps" | "fs" | "as" | "generic";
+/** Configuration of the numpy temporal data types. */
+export interface NumpyDatetime64Configuration {
+    unit: NumpyTimeUnit;
+    scale_factor: number;
+}
+/**
+ * Fill value of the numpy temporal data types: an integer count of
+ * `unit * scale_factor` since the epoch, or the `"NaT"` sentinel.
+ */
+export type NumpyDatetime64FillValue = number | "NaT";
+/** Descriptor factory shared by numpy.datetime64 and numpy.timedelta64. */
+export declare function numpyTemporalDataType(name: string): DataTypeDescriptor;
+/** The zarr-extensions `numpy.datetime64` data type. */
+export declare const numpyDatetime64: DataTypeDescriptor;
+//# sourceMappingURL=numpy-datetime64.d.ts.map

package/dist/data-type/numpy-datetime64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numpy-datetime64.d.ts","sourceRoot":"","sources":["../../src/data-type/numpy-datetime64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,oEAAoE;AACpE,MAAM,MAAM,aAAa,GACrB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GACvC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEtD,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAStE;AAED,wDAAwD;AACxD,eAAO,MAAM,eAAe,oBAA4C,CAAC"}

package/dist/data-type/numpy-datetime64.js

@@ -0,0 +1,14 @@
+import { named, simple } from "./descriptor.js";
+/** Descriptor factory shared by numpy.datetime64 and numpy.timedelta64. */
+export function numpyTemporalDataType(name) {
+    return {
+        matches: named(name),
+        requiredConfigKeys: ["unit", "scale_factor"],
+        fillIssues: (fill) => Number.isInteger(fill) || fill === "NaT"
+            ? []
+            : simple(`expected an integer or "NaT" for data type ${JSON.stringify(name)}`),
+    };
+}
+/** The zarr-extensions `numpy.datetime64` data type. */
+export const numpyDatetime64 = numpyTemporalDataType("numpy.datetime64");
+//# sourceMappingURL=numpy-datetime64.js.map

package/dist/data-type/numpy-datetime64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numpy-datetime64.js","sourceRoot":"","sources":["../../src/data-type/numpy-datetime64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAmBzE,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;QACpB,kBAAkB,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC;QAC5C,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CACnB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK;YACtC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/data-type/numpy-timedelta64.d.ts

@@ -0,0 +1,4 @@
+export type { NumpyDatetime64Configuration as NumpyTimedelta64Configuration, NumpyDatetime64FillValue as NumpyTimedelta64FillValue, } from "./numpy-datetime64.js";
+/** The zarr-extensions `numpy.timedelta64` data type. */
+export declare const numpyTimedelta64: import("./descriptor.js").DataTypeDescriptor;
+//# sourceMappingURL=numpy-timedelta64.d.ts.map

package/dist/data-type/numpy-timedelta64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numpy-timedelta64.d.ts","sourceRoot":"","sources":["../../src/data-type/numpy-timedelta64.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,4BAA4B,IAAI,6BAA6B,EAC7D,wBAAwB,IAAI,yBAAyB,GACtD,MAAM,uBAAuB,CAAC;AAE/B,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,8CAA6C,CAAC"}

package/dist/data-type/numpy-timedelta64.js

@@ -0,0 +1,4 @@
+import { numpyTemporalDataType } from "./numpy-datetime64.js";
+/** The zarr-extensions `numpy.timedelta64` data type. */
+export const numpyTimedelta64 = numpyTemporalDataType("numpy.timedelta64");
+//# sourceMappingURL=numpy-timedelta64.js.map

package/dist/data-type/numpy-timedelta64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numpy-timedelta64.js","sourceRoot":"","sources":["../../src/data-type/numpy-timedelta64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAO9D,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+import { type DataTypeDescriptor } from "./descriptor.js";
+/** Fill value of the `r<N>` raw-bits data types: one integer per byte. */
+export type RawBytesFillValue = number[];
+/**
+ * The core `r<N>` raw-bits data type family. The name itself carries a
+ * rule — N must be a positive multiple of 8 — and the fill value must
+ * hold exactly N/8 bytes.
+ */
+export declare const raw: DataTypeDescriptor;
+//# sourceMappingURL=raw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/data-type/raw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,0EAA0E;AAC1E,MAAM,MAAM,iBAAiB,GAAG,MAAM,EAAE,CAAC;AAIzC;;;;GAIG;AACH,eAAO,MAAM,GAAG,EAAE,kBAkBjB,CAAC"}

package/dist/data-type/raw.js

@@ -0,0 +1,26 @@
+import { isByteArray, simple } from "./descriptor.js";
+const RAW = /^r([1-9][0-9]*)$/;
+/**
+ * The core `r<N>` raw-bits data type family. The name itself carries a
+ * rule — N must be a positive multiple of 8 — and the fill value must
+ * hold exactly N/8 bytes.
+ */
+export const raw = {
+    matches: (name) => RAW.test(name),
+    nameIssue: (name) => {
+        const bits = Number(RAW.exec(name)[1]);
+        return bits % 8 === 0
+            ? undefined
+            : `expected "r<N>" with N a positive multiple of 8, got ${JSON.stringify(name)}`;
+    },
+    fillIssues: (fill, name) => {
+        const bits = Number(RAW.exec(name)[1]);
+        if (bits % 8 !== 0)
+            return []; // the name issue already covers this document
+        const expectedBytes = bits / 8;
+        return isByteArray(fill) && fill.length === expectedBytes
+            ? []
+            : simple(`expected an array of ${expectedBytes} integers in [0, 255] for data type ${JSON.stringify(name)}`);
+    },
+};
+//# sourceMappingURL=raw.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../src/data-type/raw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAK/E,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,GAAG,GAAuB;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;QAClB,MAAM,IAAI,GAAG,MAAM,CAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,wDAAwD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IACrF,CAAC;IACD,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,CAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,CAAC,8CAA8C;QAC7E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC;QAC/B,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa;YACvD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,CACJ,wBAAwB,aAAa,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CACnG,CAAC;IACR,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,6 @@
+import { type DataTypeDescriptor } from "./descriptor.js";
+/** Fill value of the `string` data type: a JSON unicode string. */
+export type StringFillValue = string;
+/** The zarr-extensions `string` data type (variable-length UTF-8). */
+export declare const string: DataTypeDescriptor;
+//# sourceMappingURL=string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/data-type/string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC,sEAAsE;AACtE,eAAO,MAAM,MAAM,EAAE,kBAIpB,CAAC"}

package/dist/data-type/string.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/data-type/string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAKzE,sEAAsE;AACtE,MAAM,CAAC,MAAM,MAAM,GAAuB;IACxC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;IACxB,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CACnB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,qDAAqD,CAAC;CAChG,CAAC"}

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

@@ -0,0 +1,17 @@
+import { type DataTypeDescriptor } from "./descriptor.js";
+/** One field of a `struct` data type; `data_type` recurses (structs may nest). */
+export interface StructField {
+    name: string;
+    data_type: unknown;
+}
+/** Configuration of the `struct` data type. */
+export interface StructConfiguration {
+    fields: StructField[];
+}
+/**
+ * The zarr-extensions `struct` data type (heterogeneous record). Its fill
+ * value is a JSON object mapping every field name to that field's fill
+ * value, each judged recursively against the field's own data type.
+ */
+export declare const struct: DataTypeDescriptor;
+//# sourceMappingURL=struct.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../../src/data-type/struct.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,kBAmCpB,CAAC"}

package/dist/data-type/struct.js

@@ -0,0 +1,44 @@
+import { isPlainObject } from "../guards.js";
+import { issue, named, simple } from "./descriptor.js";
+/**
+ * The zarr-extensions `struct` data type (heterogeneous record). Its fill
+ * value is a JSON object mapping every field name to that field's fill
+ * value, each judged recursively against the field's own data type.
+ */
+export const struct = {
+    matches: named("struct"),
+    requiredConfigKeys: ["fields"],
+    fillIssues: (fill, _name, context) => {
+        if (!isPlainObject(fill)) {
+            return simple('expected an object mapping field names to fill values for data type "struct"');
+        }
+        const fields = context.configuration?.["fields"];
+        if (!Array.isArray(fields))
+            return []; // config shape is the schema layer's problem
+        const declared = new Map();
+        for (const field of fields) {
+            if (isPlainObject(field) && typeof field["name"] === "string") {
+                declared.set(field["name"], field["data_type"]);
+            }
+        }
+        if (declared.size !== fields.length)
+            return []; // malformed fields: schema layer's problem
+        const issues = [];
+        for (const [fieldName, dataType] of declared) {
+            if (!Object.hasOwn(fill, fieldName)) {
+                issues.push(issue([fieldName], "missing required key", "missing_key"));
+                continue;
+            }
+            issues.push(...context
+                .fillIssuesFor(dataType, fill[fieldName], context.depth + 1)
+                .map((inner) => ({ ...inner, path: [fieldName, ...inner.path] })));
+        }
+        for (const key of Object.keys(fill)) {
+            if (!declared.has(key)) {
+                issues.push(issue([key], "unexpected member (no such struct field)"));
+            }
+        }
+        return issues;
+    },
+};
+//# sourceMappingURL=struct.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"struct.js","sourceRoot":"","sources":["../../src/data-type/struct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAahF;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAuB;IACxC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC;IACxB,kBAAkB,EAAE,CAAC,QAAQ,CAAC;IAC9B,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC,8EAA8E,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC,CAAC,6CAA6C;QACpF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC9D,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC,CAAC,2CAA2C;QAC3F,MAAM,MAAM,GAAG,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,sBAAsB,EAAE,aAAa,CAAC,CAAC,CAAC;gBACvE,SAAS;YACX,CAAC;YACD,MAAM,CAAC,IAAI,CACT,GAAG,OAAO;iBACP,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;iBAC3D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CACpE,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,0CAA0C,CAAC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}