@horizon36596/zenith-schema 0.1.1

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqE,KAAK,IAAI,EAAE,MAAM,UAAU,CAAC;AAKxG,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMf,CAAC;AAEX,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAaD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAarD;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAiCD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,QAAQ,CAgChE"}

package/dist/migrate.js

@@ -0,0 +1,109 @@
+import { autoSchema } from "./auto.js";
+import { fieldSchema } from "./field.js";
+import { FORMAT_VERSIONS, LEGACY_SCHEMA_ID, SCHEMA_ID, withCurrentSchemaId } from "./ids.js";
+import { linkSchema } from "./link.js";
+import { robotSchema } from "./robot.js";
+import { waypointsSchema } from "./waypoints.js";
+export const schemaByKind = {
+    link: linkSchema,
+    robot: robotSchema,
+    field: fieldSchema,
+    waypoints: waypointsSchema,
+    auto: autoSchema,
+};
+export class MigrationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MigrationError";
+    }
+}
+/** Both the current ids and their legacy aliases (`ids.ts`) name a kind. */
+const idToKind = new Map(Object.keys(SCHEMA_ID).flatMap((kind) => [
+    [SCHEMA_ID[kind], kind],
+    [LEGACY_SCHEMA_ID[kind], kind],
+]));
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+ * Works out which of the five files this is: from `$schema` when it is there, otherwise from the
+ * keys that only one kind has. Returns null when nothing identifies it.
+ */
+export function detectKind(json) {
+    if (!isRecord(json))
+        return null;
+    const id = json["$schema"];
+    if (typeof id === "string") {
+        const known = idToKind.get(id);
+        if (known !== undefined)
+            return known;
+    }
+    if ("steps" in json && "start" in json)
+        return "auto";
+    if ("waypoints" in json)
+        return "waypoints";
+    if ("obstacles" in json || "season" in json)
+        return "field";
+    if ("kinematics" in json || "footprint" in json)
+        return "robot";
+    if ("autosDir" in json)
+        return "link";
+    return null;
+}
+/**
+ * The same document at the next version with nothing else changed. Right for any bump whose new
+ * version only adds optional keys or step kinds: every older file is already a valid newer one
+ * once it says so.
+ */
+const bumpOnly = (to) => (doc) => ({ ...doc, formatVersion: to });
+/**
+ * The migrations, per kind, indexed by the version they start from: `steps[kind][1]` takes a v1
+ * file to v2. Every entry has a fixture pair under `packages/schema/fixtures/migrate/`.
+ *
+ * - auto 1 -> 2 (2026-09-22): v2 adds the `sequence` step kind. A v1 auto holds no sequence, so the
+ *   migration is the identity plus the version bump.
+ * - field 1 -> 2 (2026-09-22): v2 adds the optional `image` layer (site/docs/editor.md). A v1 field
+ *   has none, so again the identity plus the bump.
+ * - auto 2 -> 3 (2026-09-24): v3 adds the `piecewise` heading mode (site/docs/file-format.md,
+ *   "Piecewise heading"). A v2 auto has none, so the identity plus the bump.
+ */
+const MIGRATIONS = {
+    link: {},
+    robot: {},
+    field: { 1: bumpOnly(2) },
+    waypoints: {},
+    auto: { 1: bumpOnly(2), 2: bumpOnly(3) },
+};
+/**
+ * Brings a document up to its kind's current `formatVersion` (`FORMAT_VERSIONS`), one version at a
+ * time. A file from the future is refused by name and number, the same way the robot runtime
+ * refuses it (site/docs/file-format.md, Versioning). A legacy `$schema` alias comes back as the
+ * current id, so whatever writes the result writes the current one. The input is never mutated.
+ */
+export function migrate(json, kindHint) {
+    if (!isRecord(json))
+        throw new MigrationError("A Zenith file must be a JSON object.");
+    const kind = kindHint ?? detectKind(json);
+    if (kind === null) {
+        throw new MigrationError("Cannot tell which kind of Zenith file this is: no $schema and no distinguishing keys.");
+    }
+    const raw = json["formatVersion"];
+    if (typeof raw !== "number" || !Number.isInteger(raw)) {
+        throw new MigrationError(`A ${kind} file needs an integer formatVersion.`);
+    }
+    const current = FORMAT_VERSIONS[kind];
+    if (raw > current) {
+        throw new MigrationError(`This ${kind} file is formatVersion ${String(raw)}; this build of Zenith knows ${String(current)}.`);
+    }
+    if (raw < 1) {
+        throw new MigrationError(`formatVersion ${String(raw)} never existed; the first version is 1.`);
+    }
+    let doc = json;
+    for (let version = raw; version < current; version += 1) {
+        const step = MIGRATIONS[kind][version];
+        if (step === undefined) {
+            throw new MigrationError(`No migration takes a ${kind} file from formatVersion ${String(version)} to ${String(version + 1)}.`);
+        }
+        doc = step(doc);
+    }
+    return { kind, formatVersion: current, fromVersion: raw, data: withCurrentSchemaId(kind, doc) };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { Auto } from "./auto.js";
+import type { Field } from "./field.js";
+import type { Kind } from "./ids.js";
+import type { Link } from "./link.js";
+import type { Robot } from "./robot.js";
+import type { Waypoints } from "./waypoints.js";
+export declare class SchemaError extends Error {
+    readonly kind: Kind;
+    readonly issues: z.ZodIssue[];
+    constructor(message: string, kind: Kind, issues: z.ZodIssue[]);
+}
+/** `path/to/key: message`, the shape the CLI prints and the SCHEMA finding carries. */
+export declare function formatIssue(issue: z.ZodIssue): string;
+export declare const parseLink: (json: unknown) => Link;
+export declare const parseRobot: (json: unknown) => Robot;
+export declare const parseField: (json: unknown) => Field;
+export declare const parseWaypoints: (json: unknown) => Waypoints;
+export declare const parseAuto: (json: unknown) => Auto;
+/** Validates without throwing; the SCHEMA check wants the issue list, not an exception. */
+export declare function validateKind(kind: Kind, json: unknown): {
+    ok: true;
+    data: unknown;
+} | {
+    ok: false;
+    issues: string[];
+};
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,qBAAa,WAAY,SAAQ,KAAK;IAGlC,QAAQ,CAAC,IAAI,EAAE,IAAI;IACnB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAF7B,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAKhC;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAGrD;AAgBD,eAAO,MAAM,SAAS,GAAI,MAAM,OAAO,KAAG,IAAmC,CAAC;AAC9E,eAAO,MAAM,UAAU,GAAI,MAAM,OAAO,KAAG,KAAsC,CAAC;AAClF,eAAO,MAAM,UAAU,GAAI,MAAM,OAAO,KAAG,KAAsC,CAAC;AAClF,eAAO,MAAM,cAAc,GAAI,MAAM,OAAO,KAAG,SAAkD,CAAC;AAClG,eAAO,MAAM,SAAS,GAAI,MAAM,OAAO,KAAG,IAAmC,CAAC;AAE9E,2FAA2F;AAC3F,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,OAAO,GACZ;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAU/D"}

package/dist/parse.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { migrate, schemaByKind } from "./migrate.js";
+export class SchemaError extends Error {
+    kind;
+    issues;
+    constructor(message, kind, issues) {
+        super(message);
+        this.kind = kind;
+        this.issues = issues;
+        this.name = "SchemaError";
+    }
+}
+/** `path/to/key: message`, the shape the CLI prints and the SCHEMA finding carries. */
+export function formatIssue(issue) {
+    const where = issue.path.length === 0 ? "(root)" : issue.path.join(".");
+    return `${where}: ${issue.message}`;
+}
+function parseAs(kind, json) {
+    const migrated = migrate(json, kind);
+    const result = schemaByKind[kind].safeParse(migrated.data);
+    if (!result.success) {
+        const issues = result.error.issues;
+        throw new SchemaError(`Invalid ${kind} file:\n  ${issues.map(formatIssue).join("\n  ")}`, kind, issues);
+    }
+    return result.data;
+}
+export const parseLink = (json) => parseAs("link", json);
+export const parseRobot = (json) => parseAs("robot", json);
+export const parseField = (json) => parseAs("field", json);
+export const parseWaypoints = (json) => parseAs("waypoints", json);
+export const parseAuto = (json) => parseAs("auto", json);
+/** Validates without throwing; the SCHEMA check wants the issue list, not an exception. */
+export function validateKind(kind, json) {
+    let migrated;
+    try {
+        migrated = migrate(json, kind);
+    }
+    catch (error) {
+        return { ok: false, issues: [error instanceof Error ? error.message : String(error)] };
+    }
+    const result = schemaByKind[kind].safeParse(migrated.data);
+    if (result.success)
+        return { ok: true, data: result.data };
+    return { ok: false, issues: result.error.issues.map(formatIssue) };
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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