@horizon36596/zenith-schema 0.1.1

package/dist/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,2EAA2E;AAC3E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWzB,CAAC;AAEH,qFAAqF;AACrF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWV,CAAC;AAEjB,8DAA8D;AAC9D,eAAO,MAAM,YAAY;;;;;;;;;;;;gCAMT,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEL,0FAA0F;AAC1F,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDtB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/field.js

@@ -0,0 +1,158 @@
+import { z } from "zod";
+import { provenanceSchema } from "./common.js";
+import { formatVersionFor, schemaIdField } from "./ids.js";
+/** An axis-aligned box the robot may not drive through, with a z range. */
+export const obstacleSchema = z.object({
+    id: z.string().min(1),
+    kind: z.literal("box"),
+    minXIn: z.number(),
+    maxXIn: z.number(),
+    minYIn: z.number(),
+    maxYIn: z.number(),
+    minZIn: z.number(),
+    maxZIn: z.number(),
+    solidToRobot: z.boolean().optional(),
+    provenance: provenanceSchema.optional(),
+});
+/** An axis-aligned rectangle a rule talks about (a loading zone, a parking zone). */
+export const zoneSchema = z.object({
+    id: z.string().min(1),
+    kind: z.literal("rect"),
+    minXIn: z.number(),
+    maxXIn: z.number(),
+    minYIn: z.number(),
+    maxYIn: z.number(),
+    rule: z.string().optional(),
+    appliesInAuto: z.boolean().optional(),
+    provenance: provenanceSchema.optional(),
+});
+/**
+ * A game element or container. Seasons differ wildly here, so the known keys are optional and
+ * unknown ones survive a round trip: the season plugin reads what it put there.
+ */
+export const elementSchema = z
+    .object({
+    id: z.string().min(1),
+    kind: z.string().min(1),
+    container: z.union([z.string(), z.null()]).optional(),
+    xIn: z.number().optional(),
+    yIn: z.number().optional(),
+    radiusIn: z.number().optional(),
+    holds: z.array(z.string()).optional(),
+    provenance: provenanceSchema.optional(),
+})
+    .passthrough();
+/** Something the robot aims at. Same openness as elements. */
+export const targetSchema = z
+    .object({
+    id: z.string().min(1),
+    kind: z.string().min(1),
+    provenance: provenanceSchema.optional(),
+})
+    .passthrough();
+/**
+ * Where the field perimeter sits in the image, in image pixels (x right, y down from the image's
+ * top-left corner). The canvas maps this box onto the field's `sizeIn` in the declared frame.
+ */
+export const imagePxBoundsSchema = z
+    .object({
+    left: z.number().nonnegative(),
+    top: z.number().nonnegative(),
+    right: z.number().positive(),
+    bottom: z.number().positive(),
+})
+    .refine((box) => box.right > box.left && box.bottom > box.top, {
+    message: "pxBoundsIn needs right > left and bottom > top: it is the perimeter's box in the image",
+});
+/** One named look of the same picture, such as a dark or a printable light background. */
+export const fieldImageVariantSchema = z.object({
+    name: z.string().min(1),
+    src: z.string().min(1),
+});
+/**
+ * An optional picture of the field drawn under the vector layer (format version 2;
+ * site/docs/file-format.md has the exact mapping).
+ *
+ * - `src`: a path relative to the field file, or `app:<path>` for an asset the app ships (resolved
+ *   against the app's public root, so `app:fields/biobuzz/biobuzz-dark.webp` is
+ *   `apps/web/public/fields/biobuzz/biobuzz-dark.webp`).
+ * - `pxBoundsIn`: the box in the stored image, in image pixels, that the field perimeter occupies,
+ *   or `"fullBleed"` when the perimeter is the image's own edge.
+ * - `rotationDeg`: how far the cropped image is turned **clockwise as seen on screen** before it is
+ *   laid over the field in the field's default view; absent means 0.
+ * - `variants`: other looks of the same picture (same geometry, same credit), by name, for a
+ *   field-style setting; `src` is the one drawn when nothing else is chosen.
+ *
+ * The image is only a picture: no check reads it, and the vector geometry stays the truth.
+ */
+export const fieldImageSchema = z.object({
+    src: z.string().min(1),
+    credit: z.string().min(1),
+    pxBoundsIn: z.union([z.literal("fullBleed"), imagePxBoundsSchema]),
+    rotationDeg: z.union([z.literal(0), z.literal(90), z.literal(180), z.literal(270)]).optional(),
+    variants: z
+        .array(fieldImageVariantSchema)
+        .min(1)
+        .refine((variants) => new Set(variants.map((variant) => variant.name)).size === variants.length, {
+        message: "every image variant needs its own name",
+    })
+        .optional(),
+    provenance: provenanceSchema.optional(),
+});
+/**
+ * `*.field.json`: the season, as vector geometry in the declared frame
+ * (site/docs/file-format.md). Key declaration order is the canonical file order.
+ */
+export const fieldSchema = z.object({
+    $schema: schemaIdField("field"),
+    formatVersion: formatVersionFor("field"),
+    season: z.string().min(1),
+    name: z.string().min(1),
+    frame: z.object({
+        origin: z.enum(["centre", "corner"]),
+        xAxis: z.string().min(1),
+        yAxis: z.string().min(1),
+        headingZero: z.enum(["+x", "+y"]),
+        headingPositive: z.enum(["ccw", "cw"]),
+        units: z.enum(["in"]),
+        canonicalAlliance: z.enum(["RED", "BLUE"]),
+        mirror: z.enum(["pointSymmetry", "mirrorX", "mirrorY", "none"]),
+        view: z
+            .object({
+            audienceAt: z.enum(["bottom", "top", "left", "right"]),
+        })
+            .optional(),
+    }),
+    sizeIn: z.object({
+        xIn: z.number().positive(),
+        yIn: z.number().positive(),
+    }),
+    image: fieldImageSchema.optional(),
+    periods: z
+        .object({
+        autoS: z.number().positive(),
+        teleopS: z.number().positive(),
+    })
+        .optional(),
+    obstacles: z.array(obstacleSchema).optional(),
+    zones: z.array(zoneSchema).optional(),
+    elements: z.array(elementSchema).optional(),
+    targets: z.array(targetSchema).optional(),
+    startRules: z
+        .object({
+        touchingWall: z.boolean().optional(),
+        ownHalf: z.boolean().optional(),
+        notInZones: z.array(z.string()).optional(),
+        notTouchingContainers: z.array(z.string()).optional(),
+        holds: z.record(z.string(), z.number()).optional(),
+    })
+        .passthrough()
+        .optional(),
+    rules: z
+        .object({
+        plugin: z.string().min(1),
+    })
+        .passthrough()
+        .optional(),
+});
+//# sourceMappingURL=field.js.map

package/dist/field.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+/** The five kinds of file Zenith reads and writes (site/docs/file-format.md). */
+export declare const KINDS: readonly ["link", "robot", "field", "waypoints", "auto"];
+export type Kind = (typeof KINDS)[number];
+/** Where the v1 schemas are served, one file per kind. */
+export declare const SCHEMA_ID_BASE = "https://libraries.horizon36596.org/zenith/schema/v1/";
+/**
+ * The schema ids, one per kind. The docs site serves the schemas at these URLs, and they also ship
+ * in this package under `json/`; a reader never needs to fetch them.
+ */
+export declare const SCHEMA_ID: Record<Kind, string>;
+/**
+ * The ids files carried before v0.1.0, on a host that was never served. Files written in
+ * development still name them, so every reader accepts them as aliases of `SCHEMA_ID`; every writer
+ * writes the current id instead (site/docs/file-format.md, Schema ids). The data format is the
+ * same under both, so this is not a `formatVersion` bump.
+ */
+export declare const LEGACY_SCHEMA_ID_BASE = "https://zenith.horizon36596.org/schema/v1/";
+export declare const LEGACY_SCHEMA_ID: Record<Kind, string>;
+/** Whether `id` names `kind`, by its current id or its legacy alias. */
+export declare const isSchemaIdFor: (kind: Kind, id: string) => boolean;
+/**
+ * The same document with a legacy `$schema` alias replaced by the current id; anything else is
+ * returned as it is. Pure; never mutates.
+ */
+export declare function withCurrentSchemaId<T>(kind: Kind, doc: T): T;
+/**
+ * The `formatVersion` Zenith writes for each kind of file. Each kind is versioned on its own and
+ * bumped only when its own canonical form changes, with a migration and a fixture
+ * (`migrate.ts`). Version 2 (2026-09-22) added the `sequence` step to
+ * autos and the optional `image` to fields; auto version 3 (2026-09-24) added the `piecewise`
+ * heading mode. The link, robot and waypoints files did not change and stay at 1.
+ *
+ * The `$schema` ids above do not move with the version: they name the kind of file, and the
+ * `formatVersion` inside it says which revision of that kind it is.
+ */
+export declare const FORMAT_VERSIONS: {
+    readonly link: 1;
+    readonly robot: 1;
+    readonly field: 2;
+    readonly waypoints: 1;
+    readonly auto: 3;
+};
+/**
+ * The newest format version of any kind, which is the auto file's. Code that writes an auto file
+ * uses this; code that writes any other kind reads `FORMAT_VERSIONS` for that kind.
+ */
+export declare const FORMAT_VERSION: 3;
+/**
+ * `$schema` is optional on read, and the legacy alias is accepted; every file Zenith writes carries
+ * the current id for its kind.
+ */
+export declare const schemaIdField: (kind: Kind) => z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+/** The `formatVersion` key of one kind's current schema: exactly the version Zenith writes. */
+export declare const formatVersionFor: <K extends Kind>(kind: K) => z.ZodLiteral<{
+    readonly link: 1;
+    readonly robot: 1;
+    readonly field: 2;
+    readonly waypoints: 1;
+    readonly auto: 3;
+}[K]>;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,eAAO,MAAM,KAAK,0DAA2D,CAAC;AAC9E,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,cAAc,yDAAyD,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAM1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,+CAA+C,CAAC;AAElF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAMjD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,EAAE,IAAI,MAAM,KAAG,OACE,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAK5D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;CAMuB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAuB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,6DAMzB,CAAC;AAEhB,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,IAAI,EAAE,MAAM,CAAC;;;;;;KACO,CAAC"}

package/dist/ids.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+/** The five kinds of file Zenith reads and writes (site/docs/file-format.md). */
+export const KINDS = ["link", "robot", "field", "waypoints", "auto"];
+/** Where the v1 schemas are served, one file per kind. */
+export const SCHEMA_ID_BASE = "https://libraries.horizon36596.org/zenith/schema/v1/";
+/**
+ * The schema ids, one per kind. The docs site serves the schemas at these URLs, and they also ship
+ * in this package under `json/`; a reader never needs to fetch them.
+ */
+export const SCHEMA_ID = {
+    link: `${SCHEMA_ID_BASE}link.json`,
+    robot: `${SCHEMA_ID_BASE}robot.json`,
+    field: `${SCHEMA_ID_BASE}field.json`,
+    waypoints: `${SCHEMA_ID_BASE}waypoints.json`,
+    auto: `${SCHEMA_ID_BASE}auto.json`,
+};
+/**
+ * The ids files carried before v0.1.0, on a host that was never served. Files written in
+ * development still name them, so every reader accepts them as aliases of `SCHEMA_ID`; every writer
+ * writes the current id instead (site/docs/file-format.md, Schema ids). The data format is the
+ * same under both, so this is not a `formatVersion` bump.
+ */
+export const LEGACY_SCHEMA_ID_BASE = "https://zenith.horizon36596.org/schema/v1/";
+export const LEGACY_SCHEMA_ID = {
+    link: `${LEGACY_SCHEMA_ID_BASE}link.json`,
+    robot: `${LEGACY_SCHEMA_ID_BASE}robot.json`,
+    field: `${LEGACY_SCHEMA_ID_BASE}field.json`,
+    waypoints: `${LEGACY_SCHEMA_ID_BASE}waypoints.json`,
+    auto: `${LEGACY_SCHEMA_ID_BASE}auto.json`,
+};
+/** Whether `id` names `kind`, by its current id or its legacy alias. */
+export const isSchemaIdFor = (kind, id) => id === SCHEMA_ID[kind] || id === LEGACY_SCHEMA_ID[kind];
+/**
+ * The same document with a legacy `$schema` alias replaced by the current id; anything else is
+ * returned as it is. Pure; never mutates.
+ */
+export function withCurrentSchemaId(kind, doc) {
+    if (typeof doc !== "object" || doc === null || Array.isArray(doc))
+        return doc;
+    const record = doc;
+    if (record["$schema"] !== LEGACY_SCHEMA_ID[kind])
+        return doc;
+    return { ...record, $schema: SCHEMA_ID[kind] };
+}
+/**
+ * The `formatVersion` Zenith writes for each kind of file. Each kind is versioned on its own and
+ * bumped only when its own canonical form changes, with a migration and a fixture
+ * (`migrate.ts`). Version 2 (2026-09-22) added the `sequence` step to
+ * autos and the optional `image` to fields; auto version 3 (2026-09-24) added the `piecewise`
+ * heading mode. The link, robot and waypoints files did not change and stay at 1.
+ *
+ * The `$schema` ids above do not move with the version: they name the kind of file, and the
+ * `formatVersion` inside it says which revision of that kind it is.
+ */
+export const FORMAT_VERSIONS = {
+    link: 1,
+    robot: 1,
+    field: 2,
+    waypoints: 1,
+    auto: 3,
+};
+/**
+ * The newest format version of any kind, which is the auto file's. Code that writes an auto file
+ * uses this; code that writes any other kind reads `FORMAT_VERSIONS` for that kind.
+ */
+export const FORMAT_VERSION = FORMAT_VERSIONS.auto;
+/**
+ * `$schema` is optional on read, and the legacy alias is accepted; every file Zenith writes carries
+ * the current id for its kind.
+ */
+export const schemaIdField = (kind) => z
+    .string()
+    .refine((value) => isSchemaIdFor(kind, value), {
+    message: `$schema must be ${SCHEMA_ID[kind]}`,
+})
+    .optional();
+/** The `formatVersion` key of one kind's current schema: exactly the version Zenith writes. */
+export const formatVersionFor = (kind) => z.literal(FORMAT_VERSIONS[kind]);
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAU,CAAC;AAG9E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,sDAAsD,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C,IAAI,EAAE,GAAG,cAAc,WAAW;IAClC,KAAK,EAAE,GAAG,cAAc,YAAY;IACpC,KAAK,EAAE,GAAG,cAAc,YAAY;IACpC,SAAS,EAAE,GAAG,cAAc,gBAAgB;IAC5C,IAAI,EAAE,GAAG,cAAc,WAAW;CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,4CAA4C,CAAC;AAElF,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,IAAI,EAAE,GAAG,qBAAqB,WAAW;IACzC,KAAK,EAAE,GAAG,qBAAqB,YAAY;IAC3C,KAAK,EAAE,GAAG,qBAAqB,YAAY;IAC3C,SAAS,EAAE,GAAG,qBAAqB,gBAAgB;IACnD,IAAI,EAAE,GAAG,qBAAqB,WAAW;CAC1C,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAE,EAAU,EAAW,EAAE,CAC/D,EAAE,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAI,IAAU,EAAE,GAAM;IACvD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC9E,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7D,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,EAAO,CAAC;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;CAC0C,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAE,EAAE,CAC1C,CAAC;KACE,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;IAC7C,OAAO,EAAE,mBAAmB,SAAS,CAAC,IAAI,CAAC,EAAE;CAC9C,CAAC;KACD,QAAQ,EAAE,CAAC;AAEhB,+FAA+F;AAC/F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAiB,IAAO,EAAE,EAAE,CAC1D,CAAC,CAAC,OAAO,CAA8B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @horizon36596/zenith-schema: the five file formats of site/docs/file-format.md as zod schemas,
+ * the TypeScript types inferred from them, the `estimateS` expression grammar and the migrations.
+ *
+ * Pure: no DOM, no clock, no randomness, no Node APIs (CLAUDE.md rule 1).
+ */
+export * from "./ids.js";
+export * from "./common.js";
+export * from "./expr.js";
+export * from "./link.js";
+export * from "./robot.js";
+export * from "./field.js";
+export * from "./waypoints.js";
+export * from "./auto.js";
+export * from "./migrate.js";
+export * from "./parse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @horizon36596/zenith-schema: the five file formats of site/docs/file-format.md as zod schemas,
+ * the TypeScript types inferred from them, the `estimateS` expression grammar and the migrations.
+ *
+ * Pure: no DOM, no clock, no randomness, no Node APIs (CLAUDE.md rule 1).
+ */
+export * from "./ids.js";
+export * from "./common.js";
+export * from "./expr.js";
+export * from "./link.js";
+export * from "./robot.js";
+export * from "./field.js";
+export * from "./waypoints.js";
+export * from "./auto.js";
+export * from "./migrate.js";
+export * from "./parse.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/jsonschema.d.ts

@@ -0,0 +1,14 @@
+import { type Kind } from "./ids.js";
+/** The meta-schema every generated file declares. */
+export declare const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/**
+ * Generates the JSON Schema for one kind from its zod schema.
+ *
+ * zod-to-json-schema has no 2020-12 target; its 2019-09 output is a subset that validates
+ * unchanged under 2020-12 (we use no tuples, so there is no `prefixItems` question), so the
+ * dialect and the `$id` are set here rather than by the converter.
+ */
+export declare function toJsonSchema(kind: Kind): Record<string, unknown>;
+/** The canonical text of a generated schema file: two-space indent, LF, trailing newline. */
+export declare function jsonSchemaText(kind: Kind): string;
+//# sourceMappingURL=jsonschema.d.ts.map

package/dist/jsonschema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.d.ts","sourceRoot":"","sources":["../src/jsonschema.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,IAAI,EAAE,MAAM,UAAU,CAAC;AAGjE,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,iDAAiD,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAahE;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEjD"}

package/dist/jsonschema.js

@@ -0,0 +1,31 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { FORMAT_VERSIONS, SCHEMA_ID } from "./ids.js";
+import { schemaByKind } from "./migrate.js";
+/** The meta-schema every generated file declares. */
+export const JSON_SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
+/**
+ * Generates the JSON Schema for one kind from its zod schema.
+ *
+ * zod-to-json-schema has no 2020-12 target; its 2019-09 output is a subset that validates
+ * unchanged under 2020-12 (we use no tuples, so there is no `prefixItems` question), so the
+ * dialect and the `$id` are set here rather than by the converter.
+ */
+export function toJsonSchema(kind) {
+    const generated = zodToJsonSchema(schemaByKind[kind], {
+        target: "jsonSchema2019-09",
+        definitionPath: "$defs",
+        errorMessages: false,
+    });
+    delete generated["$schema"];
+    return {
+        $schema: JSON_SCHEMA_DIALECT,
+        $id: SCHEMA_ID[kind],
+        title: `Zenith ${kind} file, formatVersion ${String(FORMAT_VERSIONS[kind])}`,
+        ...generated,
+    };
+}
+/** The canonical text of a generated schema file: two-space indent, LF, trailing newline. */
+export function jsonSchemaText(kind) {
+    return `${JSON.stringify(toJsonSchema(kind), null, 2)}\n`;
+}
+//# sourceMappingURL=jsonschema.js.map

package/dist/jsonschema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.js","sourceRoot":"","sources":["../src/jsonschema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAa,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,8CAA8C,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,SAAS,GAAG,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;QACpD,MAAM,EAAE,mBAAmB;QAC3B,cAAc,EAAE,OAAO;QACvB,aAAa,EAAE,KAAK;KACrB,CAA4B,CAAC;IAC9B,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5B,OAAO;QACL,OAAO,EAAE,mBAAmB;QAC5B,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC;QACpB,KAAK,EAAE,UAAU,IAAI,wBAAwB,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE;QAC5E,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,IAAU;IACvC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC"}

package/dist/link.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+/**
+ * `zenith.json`: the link file at the robot repository root. It says where everything else lives
+ * and how to run the simulator (site/docs/file-format.md).
+ *
+ * Key declaration order below is the canonical file order; canonicalize() follows it.
+ */
+export declare const linkSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    formatVersion: z.ZodLiteral<1>;
+    autosDir: z.ZodString;
+    robot: z.ZodString;
+    field: z.ZodString;
+    waypoints: z.ZodOptional<z.ZodString>;
+    deploy: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<["androidAssets", "directory"]>;
+        dir: z.ZodString;
+        /**
+         * The command library the robot runtime builds on: `"solverslib"` (the
+         * `org.horizon36596.zenith.solverslib` classes) or `"ivy"` (the `org.horizon36596.zenith.ivy` classes).
+         * Neither is a default. It is optional here so that a file without it still loads in the editor
+         * and validates, and so that a project that writes no Java needs none. Every command that writes
+         * Java refuses until it is set: `zenith codegen`, and `zenith deploy` and the desktop app's Deploy
+         * when there is a `codegen` section, because only then do they write OpMode stubs
+         * (site/docs/command-libraries.md). It decides what the stubs and generated classes import;
+         * nothing in an `*.auto.json` names a library.
+         */
+        commandLibrary: z.ZodOptional<z.ZodEnum<["solverslib", "ivy"]>>;
+        /**
+         * The team's `ZenithRobot` implementation, fully qualified, with a public
+         * no-argument constructor. Every OpMode stub `zenith deploy` writes constructs one, so it is
+         * required once `codegen` is set. A dotted Java name and nothing else, because it is written into
+         * Java source.
+         */
+        robotClass: z.ZodOptional<z.ZodString>;
+        /** The TeleOp the Driver Station preselects after each generated auto. Omitted when unset. */
+        preselectTeleOp: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "androidAssets" | "directory";
+        dir: string;
+        commandLibrary?: "solverslib" | "ivy" | undefined;
+        robotClass?: string | undefined;
+        preselectTeleOp?: string | undefined;
+    }, {
+        kind: "androidAssets" | "directory";
+        dir: string;
+        commandLibrary?: "solverslib" | "ivy" | undefined;
+        robotClass?: string | undefined;
+        preselectTeleOp?: string | undefined;
+    }>>;
+    sim: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        trace: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        trace: string;
+    }, {
+        command: string;
+        trace: string;
+    }>>;
+    codegen: z.ZodOptional<z.ZodObject<{
+        package: z.ZodString;
+        dir: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        dir: string;
+        package: string;
+    }, {
+        dir: string;
+        package: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    robot: string;
+    field: string;
+    formatVersion: 1;
+    autosDir: string;
+    waypoints?: string | undefined;
+    $schema?: string | undefined;
+    deploy?: {
+        kind: "androidAssets" | "directory";
+        dir: string;
+        commandLibrary?: "solverslib" | "ivy" | undefined;
+        robotClass?: string | undefined;
+        preselectTeleOp?: string | undefined;
+    } | undefined;
+    sim?: {
+        command: string;
+        trace: string;
+    } | undefined;
+    codegen?: {
+        dir: string;
+        package: string;
+    } | undefined;
+}, {
+    robot: string;
+    field: string;
+    formatVersion: 1;
+    autosDir: string;
+    waypoints?: string | undefined;
+    $schema?: string | undefined;
+    deploy?: {
+        kind: "androidAssets" | "directory";
+        dir: string;
+        commandLibrary?: "solverslib" | "ivy" | undefined;
+        robotClass?: string | undefined;
+        preselectTeleOp?: string | undefined;
+    } | undefined;
+    sim?: {
+        command: string;
+        trace: string;
+    } | undefined;
+    codegen?: {
+        dir: string;
+        package: string;
+    } | undefined;
+}>;
+export type Link = z.infer<typeof linkSchema>;
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;QAWjB;;;;;;;;;WASG;;QAEH;;;;;WAKG;;QAKH,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBlG,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/link.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { formatVersionFor, schemaIdField } from "./ids.js";
+/**
+ * `zenith.json`: the link file at the robot repository root. It says where everything else lives
+ * and how to run the simulator (site/docs/file-format.md).
+ *
+ * Key declaration order below is the canonical file order; canonicalize() follows it.
+ */
+export const linkSchema = z.object({
+    $schema: schemaIdField("link"),
+    formatVersion: formatVersionFor("link"),
+    autosDir: z.string().min(1),
+    robot: z.string().min(1),
+    field: z.string().min(1),
+    waypoints: z.string().min(1).optional(),
+    deploy: z
+        .object({
+        kind: z.enum(["androidAssets", "directory"]),
+        dir: z.string().min(1),
+        /**
+         * The command library the robot runtime builds on: `"solverslib"` (the
+         * `org.horizon36596.zenith.solverslib` classes) or `"ivy"` (the `org.horizon36596.zenith.ivy` classes).
+         * Neither is a default. It is optional here so that a file without it still loads in the editor
+         * and validates, and so that a project that writes no Java needs none. Every command that writes
+         * Java refuses until it is set: `zenith codegen`, and `zenith deploy` and the desktop app's Deploy
+         * when there is a `codegen` section, because only then do they write OpMode stubs
+         * (site/docs/command-libraries.md). It decides what the stubs and generated classes import;
+         * nothing in an `*.auto.json` names a library.
+         */
+        commandLibrary: z.enum(["solverslib", "ivy"]).optional(),
+        /**
+         * The team's `ZenithRobot` implementation, fully qualified, with a public
+         * no-argument constructor. Every OpMode stub `zenith deploy` writes constructs one, so it is
+         * required once `codegen` is set. A dotted Java name and nothing else, because it is written into
+         * Java source.
+         */
+        robotClass: z
+            .string()
+            .regex(/^[A-Za-z_$][A-Za-z0-9_$]*(\.[A-Za-z_$][A-Za-z0-9_$]*)*$/, "a fully qualified Java class name")
+            .optional(),
+        /** The TeleOp the Driver Station preselects after each generated auto. Omitted when unset. */
+        preselectTeleOp: z.string().min(1).optional(),
+    })
+        .optional(),
+    sim: z
+        .object({
+        command: z.string().min(1),
+        trace: z.string().min(1),
+    })
+        .optional(),
+    codegen: z
+        .object({
+        package: z.string().min(1),
+        dir: z.string().min(1),
+    })
+        .optional(),
+});
+//# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC;IAC9B,aAAa,EAAE,gBAAgB,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAC5C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB;;;;;;;;;WASG;QACH,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;QACxD;;;;;WAKG;QACH,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,KAAK,CAAC,yDAAyD,EAAE,mCAAmC,CAAC;aACrG,QAAQ,EAAE;QACb,8FAA8F;QAC9F,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC9C,CAAC;SACD,QAAQ,EAAE;IACb,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACzB,CAAC;SACD,QAAQ,EAAE;IACb,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACvB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}