@horizon36596/zenith-core 0.1.1

package/dist/edit/path.js

@@ -0,0 +1,135 @@
+import { EditError } from "./errors.js";
+import { finish } from "./finish.js";
+import { updateStep } from "./tree.js";
+function asPathStep(step, stepId) {
+    if (step.kind !== "path") {
+        throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, not a path.`);
+    }
+}
+/**
+ * Sets one point of one segment of a path step to a literal pose: a segment endpoint (`from` or
+ * `to`, replacing whatever pose source — inline pose, waypoint ref or `"current"` — was there) or
+ * one Bezier control point.
+ */
+export function setPose(auto, stepId, target, pose) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        const segment = step.segments[target.segmentIndex];
+        if (segment === undefined) {
+            throw new EditError(`Step ${JSON.stringify(stepId)} has no segment at index ${String(target.segmentIndex)}.`);
+        }
+        const segments = [...step.segments];
+        if (target.pointKind === "control") {
+            if (segment.kind !== "bezier") {
+                throw new EditError(`Segment ${String(target.segmentIndex)} of step ${JSON.stringify(stepId)} is a line; it has no control points.`);
+            }
+            if (target.controlIndex === undefined) {
+                throw new EditError('A "control" pose target needs controlIndex.');
+            }
+            const control = [...segment.control];
+            if (control[target.controlIndex] === undefined) {
+                throw new EditError(`Segment ${String(target.segmentIndex)} of step ${JSON.stringify(stepId)} has no control point at index ${String(target.controlIndex)}.`);
+            }
+            control[target.controlIndex] = { ...pose };
+            segments[target.segmentIndex] = { ...segment, control };
+        }
+        else if (target.pointKind === "from") {
+            segments[target.segmentIndex] = { ...segment, from: { ...pose } };
+        }
+        else {
+            segments[target.segmentIndex] = { ...segment, to: { ...pose } };
+        }
+        return { ...step, segments };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Replaces a path step's heading mode outright. */
+export function setHeadingMode(auto, stepId, heading) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        return { ...step, heading };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Sets a path step's `speedFraction` (0 exclusive, 1 inclusive; the schema enforces the range). */
+export function setSpeed(auto, stepId, fraction) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        return { ...step, speedFraction: fraction };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Appends a segment to a path step. A path's segments must stay continuous; `validate` checks that. */
+export function addSegment(auto, stepId, segment) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        return { ...step, segments: [...step.segments, segment] };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Removes the segment at `segmentIndex`. A path step needs at least one segment. */
+export function removeSegment(auto, stepId, segmentIndex) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        if (step.segments[segmentIndex] === undefined) {
+            throw new EditError(`Step ${JSON.stringify(stepId)} has no segment at index ${String(segmentIndex)}.`);
+        }
+        if (step.segments.length <= 1) {
+            throw new EditError(`Step ${JSON.stringify(stepId)} has only one segment; a path step needs at least one.`);
+        }
+        return { ...step, segments: step.segments.filter((_, index) => index !== segmentIndex) };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Adds a marker to a path step. */
+export function addMarker(auto, stepId, marker) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        return { ...step, markers: [...(step.markers ?? []), marker] };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Removes the marker at `markerIndex` from a path step. */
+export function removeMarker(auto, stepId, markerIndex) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        const markers = step.markers ?? [];
+        if (markers[markerIndex] === undefined) {
+            throw new EditError(`Step ${JSON.stringify(stepId)} has no marker at index ${String(markerIndex)}.`);
+        }
+        return { ...step, markers: markers.filter((_, index) => index !== markerIndex) };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+/** Moves a marker to a new `at` (path parameter, distance, or distance from the end). */
+export function setMarkerAt(auto, stepId, markerIndex, at) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        asPathStep(step, stepId);
+        const markers = step.markers ?? [];
+        if (markers[markerIndex] === undefined) {
+            throw new EditError(`Step ${JSON.stringify(stepId)} has no marker at index ${String(markerIndex)}.`);
+        }
+        return {
+            ...step,
+            markers: markers.map((marker, index) => (index === markerIndex ? { ...marker, at } : marker)),
+        };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+//# sourceMappingURL=path.js.map

package/dist/edit/path.js.map

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

package/dist/edit/steps.d.ts

@@ -0,0 +1,53 @@
+import { type Auto, type Step } from "@horizon36596/zenith-schema";
+/**
+ * Adds `step` to the auto: after the step named `afterId`, wherever it is in the tree (top level,
+ * inside a `parallel` group, or inside a `branch` arm), or at the end of the top-level list when
+ * `afterId` is omitted.
+ *
+ * A step with no explicit `id` is given one here (its kind, disambiguated with `-2`, `-3`, ... if
+ * that is taken): a newly added step should always have a stable id an agent can refer to next,
+ * not a positional one that shifts under later edits.
+ *
+ * Uniqueness is decided against the ids the document has *after* the insertion, not before it.
+ * Inserting shifts every positional id below the insertion point by one, so three unnamed steps
+ * (`step1`, `step2`, `step3`) plus a new `step4` is a collision the before-picture cannot see.
+ */
+export declare function addStep(auto: Auto, step: Step, afterId?: string | IntoGroup): Auto;
+/**
+ * A place inside a group rather than after a step: `index` (0-based, clamped; the end when
+ * absent) in the group's own list, or in the `then` or `else` arm of a branch (`then` when
+ * absent). This is how a step goes into a group that is empty of the place it should go, such as
+ * the front of a sequence; "after this member" is the plain id form.
+ */
+export interface IntoGroup {
+    into: string;
+    index?: number;
+    arm?: "then" | "else";
+}
+/**
+ * Removes the step named `id`, wherever it is in the tree.
+ *
+ * A `parallel` group left naming the removed step as its `deadline` has the reference dropped
+ * rather than repointed: no other member is the step whose end was meant to end the group, and a
+ * silent substitution would change what the routine does. The group is then a `deadline` group with
+ * no deadline, which `check` reports as a SCHEMA error for a human to resolve.
+ */
+export declare function removeStep(auto: Auto, id: string): Auto;
+/**
+ * Moves the step named `id` to a new position: immediately after another step's id (searched
+ * for in whatever list currently holds it, top level or nested), or to a numbered index
+ * (0-based, clamped) in the top-level `steps` list. A numbered target always lands the step at
+ * the top level, even if it started inside a `parallel` or `branch` group, because an index only
+ * means something within one flat list and the top level is the only one every caller can name
+ * without also knowing the tree's shape. An `IntoGroup` target puts it at an index inside a
+ * sequence, parallel group or branch arm, which is how a step moves into a group (or to the front
+ * of one); moving it after a top-level step, or to a number, moves it out again.
+ */
+export declare function moveStep(auto: Auto, id: string, target: string | number | IntoGroup): Auto;
+/**
+ * Gives the step named `id` a new explicit id. When the step is a child of a `parallel` group
+ * whose `deadline` names the old id, the parent's `deadline` is updated too, so the rename does
+ * not silently orphan the deadline reference.
+ */
+export declare function renameStep(auto: Auto, id: string, newId: string): Auto;
+//# sourceMappingURL=steps.d.ts.map

package/dist/edit/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/edit/steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAM/F;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAiBlF;AAQD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AA0CD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAkC1F;AA4BD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAStE"}

package/dist/edit/steps.js.map

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

package/dist/edit/template.d.ts

@@ -0,0 +1,18 @@
+import { type Auto } from "@horizon36596/zenith-schema";
+export interface AutoTemplate {
+    alliance: "RED" | "BLUE";
+    /** The same shape as `Auto["start"]`: a pose (or a waypoint ref) and optionally what it holds. */
+    start: Auto["start"];
+    /** Overrides the project's `zenith.json` robot file, the way `auto.robot` does. */
+    robotPath?: string;
+    /** Overrides the project's `zenith.json` field file, the way `auto.field` does. */
+    fieldPath?: string;
+}
+/**
+ * Builds a new auto from scratch: `name`, the template's alliance and start, and one placeholder
+ * leg so the file is valid immediately (the schema requires at least one step). The leg starts
+ * from `"current"`, which resolves against `start` the same way the first step of any auto does
+ * (`packages/core/src/resolve.ts`), so there is nothing to fill in before this validates.
+ */
+export declare function newAutoFromTemplate(name: string, template: AutoTemplate): Auto;
+//# sourceMappingURL=template.d.ts.map

package/dist/edit/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/edit/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC;IACzB,kGAAkG;IAClG,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAoB9E"}

package/dist/edit/template.js

@@ -0,0 +1,30 @@
+import { FORMAT_VERSION, SCHEMA_ID } from "@horizon36596/zenith-schema";
+import { finish } from "./finish.js";
+/**
+ * Builds a new auto from scratch: `name`, the template's alliance and start, and one placeholder
+ * leg so the file is valid immediately (the schema requires at least one step). The leg starts
+ * from `"current"`, which resolves against `start` the same way the first step of any auto does
+ * (`packages/core/src/resolve.ts`), so there is nothing to fill in before this validates.
+ */
+export function newAutoFromTemplate(name, template) {
+    return finish({
+        $schema: SCHEMA_ID.auto,
+        formatVersion: FORMAT_VERSION,
+        name,
+        title: name,
+        robot: template.robotPath,
+        field: template.fieldPath,
+        alliance: template.alliance,
+        start: template.start,
+        steps: [
+            {
+                id: "leg1",
+                kind: "path",
+                segments: [{ kind: "line", from: "current", to: { xIn: 0, yIn: 24 } }],
+                heading: { mode: "tangent" },
+                notes: "Replace this leg with the real opening move.",
+            },
+        ],
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/edit/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/edit/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAa,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAYrC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,QAAsB;IACtE,OAAO,MAAM,CAAC;QACZ,OAAO,EAAE,SAAS,CAAC,IAAI;QACvB,aAAa,EAAE,cAAc;QAC7B,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,QAAQ,CAAC,SAAS;QACzB,KAAK,EAAE,QAAQ,CAAC,SAAS;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC;gBACtE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC5B,KAAK,EAAE,8CAA8C;aACtD;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/edit/timing.d.ts

@@ -0,0 +1,11 @@
+import type { Auto } from "@horizon36596/zenith-schema";
+/**
+ * Sets or clears a step's `timeoutS`. Only `path`, `command` and `wait` steps carry one; a
+ * `parallel` or `branch` step has no timeout of its own (site/docs/file-format.md, step kinds).
+ *
+ * Named to match the other edit primitives; it shadows the global
+ * `setTimeout` only within this module, and this package never schedules a timer (CLAUDE.md
+ * rule 1: no clock in `packages/core`).
+ */
+export declare function setTimeout(auto: Auto, stepId: string, timeoutS: number | undefined): Auto;
+//# sourceMappingURL=timing.d.ts.map

package/dist/edit/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/edit/timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAKxD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAWzF"}

package/dist/edit/timing.js

@@ -0,0 +1,23 @@
+import { EditError } from "./errors.js";
+import { finish } from "./finish.js";
+import { updateStep } from "./tree.js";
+/**
+ * Sets or clears a step's `timeoutS`. Only `path`, `command` and `wait` steps carry one; a
+ * `parallel` or `branch` step has no timeout of its own (site/docs/file-format.md, step kinds).
+ *
+ * Named to match the other edit primitives; it shadows the global
+ * `setTimeout` only within this module, and this package never schedules a timer (CLAUDE.md
+ * rule 1: no clock in `packages/core`).
+ */
+export function setTimeout(auto, stepId, timeoutS) {
+    const result = updateStep(auto.steps, "step", stepId, (step) => {
+        if (step.kind !== "path" && step.kind !== "command" && step.kind !== "wait") {
+            throw new EditError(`Step ${JSON.stringify(stepId)} is a ${step.kind} step, which has no timeoutS.`);
+        }
+        return { ...step, timeoutS };
+    });
+    if (!result.found)
+        throw new EditError(`No step with id ${JSON.stringify(stepId)}.`);
+    return finish({ ...auto, steps: result.steps });
+}
+//# sourceMappingURL=timing.js.map

package/dist/edit/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/edit/timing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,MAAc,EAAE,QAA4B;IACjF,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5E,MAAM,IAAI,SAAS,CACjB,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,+BAA+B,CAChF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrF,OAAO,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/edit/tree.d.ts

@@ -0,0 +1,32 @@
+import { type Step } from "@horizon36596/zenith-schema";
+/**
+ * What `updateStep`'s callback returns for the step it found: a replacement, `"remove"` to drop
+ * the step from its containing list, or `undefined` to leave it exactly as it was.
+ */
+export type StepUpdate = Step | "remove" | undefined;
+export interface UpdateResult {
+    steps: Step[];
+    found: boolean;
+}
+/**
+ * Walks a step forest — the top-level list plus every `sequence.steps`, `parallel.steps` and
+ * `branch.then`/`else` nested inside it — looking for the one step whose effective id
+ * (`effectiveId`) is `targetId`, and rebuilds the forest with `update` applied to it. Every list on the path back to the root is
+ * a new array; every step not on that path is the same object it was, so this never mutates the
+ * auto it is given.
+ *
+ * Ids are unique by construction: `finish` refuses any edit that would repeat one and `check`
+ * raises a SCHEMA error for a hand-written file that does, so the walk stops looking as soon as it
+ * finds a match. On a document that has slipped through anyway, the first match in document order
+ * is the one every caller acts on, which is also the one whose finding is reported first.
+ */
+export declare function updateStep(steps: readonly Step[], prefix: string, targetId: string, update: (step: Step, id: string) => StepUpdate): UpdateResult;
+/** `updateStep`, but only to read the matching step out without changing the forest. */
+export declare function findStep(steps: readonly Step[], prefix: string, targetId: string): Step | null;
+/**
+ * Inserts `newStep` immediately after the step whose effective id is `afterId`, in whichever list
+ * — top level, a sequence's or parallel group's `steps`, or a branch's `then`/`else` — actually
+ * contains it.
+ */
+export declare function insertAfter(steps: readonly Step[], prefix: string, afterId: string, newStep: Step): UpdateResult;
+//# sourceMappingURL=tree.d.ts.map

package/dist/edit/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/edit/tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGpF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,GAC7C,YAAY,CA0Bd;AAuBD,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAO9F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,GACZ,YAAY,CAyBd"}

package/dist/edit/tree.js

@@ -0,0 +1,90 @@
+import { childLists, withChildLists } from "@horizon36596/zenith-schema";
+import { childPrefix, effectiveId } from "./ids.js";
+/**
+ * Walks a step forest — the top-level list plus every `sequence.steps`, `parallel.steps` and
+ * `branch.then`/`else` nested inside it — looking for the one step whose effective id
+ * (`effectiveId`) is `targetId`, and rebuilds the forest with `update` applied to it. Every list on the path back to the root is
+ * a new array; every step not on that path is the same object it was, so this never mutates the
+ * auto it is given.
+ *
+ * Ids are unique by construction: `finish` refuses any edit that would repeat one and `check`
+ * raises a SCHEMA error for a hand-written file that does, so the walk stops looking as soon as it
+ * finds a match. On a document that has slipped through anyway, the first match in document order
+ * is the one every caller acts on, which is also the one whose finding is reported first.
+ */
+export function updateStep(steps, prefix, targetId, update) {
+    let found = false;
+    const result = [];
+    for (const [index, step] of steps.entries()) {
+        if (found) {
+            result.push(step);
+            continue;
+        }
+        const id = effectiveId(step, index, prefix);
+        if (id === targetId) {
+            found = true;
+            const outcome = update(step, id);
+            if (outcome !== "remove")
+                result.push(outcome === undefined ? step : outcome);
+            continue;
+        }
+        const nested = inChildren(step, id, (list, childPrefixed) => updateStep(list, childPrefixed, targetId, update));
+        if (nested !== null)
+            found = true;
+        result.push(nested ?? step);
+    }
+    return { steps: result, found };
+}
+/**
+ * Tries `visit` on each child list of a group step in turn and stops at the first that finds its
+ * target, returning the group rebuilt around the changed list; null when no list held the target
+ * (or the step is a leaf). Every walker in this file recurses through here, so sequence, parallel
+ * and branch steps are all searched alike.
+ */
+function inChildren(step, id, visit) {
+    const lists = childLists(step);
+    for (const [listIndex, list] of lists.entries()) {
+        const child = visit(list, childPrefix(id, lists.length, listIndex));
+        if (!child.found)
+            continue;
+        const rebuilt = lists.map((original, i) => (i === listIndex ? child.steps : original));
+        return withChildLists(step, rebuilt);
+    }
+    return null;
+}
+/** `updateStep`, but only to read the matching step out without changing the forest. */
+export function findStep(steps, prefix, targetId) {
+    let found = null;
+    updateStep(steps, prefix, targetId, (step) => {
+        found = step;
+        return undefined;
+    });
+    return found;
+}
+/**
+ * Inserts `newStep` immediately after the step whose effective id is `afterId`, in whichever list
+ * — top level, a sequence's or parallel group's `steps`, or a branch's `then`/`else` — actually
+ * contains it.
+ */
+export function insertAfter(steps, prefix, afterId, newStep) {
+    let found = false;
+    const result = [];
+    for (const [index, step] of steps.entries()) {
+        if (found) {
+            result.push(step);
+            continue;
+        }
+        const id = effectiveId(step, index, prefix);
+        if (id === afterId) {
+            found = true;
+            result.push(step, newStep);
+            continue;
+        }
+        const nested = inChildren(step, id, (list, childPrefixed) => insertAfter(list, childPrefixed, afterId, newStep));
+        if (nested !== null)
+            found = true;
+        result.push(nested ?? step);
+    }
+    return { steps: result, found };
+}
+//# sourceMappingURL=tree.js.map

package/dist/edit/tree.js.map

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

package/dist/estimate.d.ts

@@ -0,0 +1,48 @@
+import { type CommandSpec, type Robot } from "@horizon36596/zenith-schema";
+import { type RobotLimits } from "./kinematics.js";
+import type { Estimate, Plan } from "./types.js";
+/** One sample of the velocity profile along a path step. */
+interface ProfileSample {
+    sIn: number;
+    /** The direction of travel minus the robot's heading: 0 is nose-first, pi/2 is a left strafe. */
+    phiRad: number;
+    /** The cap from the velocity ellipse, the heading rate and the curvature, all applied. */
+    capInPerS: number;
+    /** The coasting deceleration available in this travel direction. */
+    decelInPerS2: number;
+}
+export interface PathTiming {
+    seconds: number;
+    strafeFraction: number;
+    exitVelocityInPerS: number;
+    /** Cumulative seconds at each plan sample, so a caller can turn a time into a place on the path. */
+    timeAtSampleS: number[];
+}
+/**
+ * The two-pass profile of `03` section 3 step 6: take the minimum of the caps, raise it forwards
+ * under `accel` from the entry velocity, lower it backwards under the direction's deceleration into
+ * the exit velocity, then integrate `ds / v`.
+ */
+export declare function integrateProfile(samples: readonly ProfileSample[], limits: RobotLimits, entryVelocityInPerS: number, exitVelocityInPerS: number): PathTiming;
+/** The numbers a command's `estimateS` expression may name: its arguments, resolved to seconds. */
+export declare function commandScope(spec: CommandSpec | undefined, args: Readonly<Record<string, string | number | boolean>> | undefined, robot: Robot): Record<string, number>;
+/** The seconds a command step takes, or null when its registry entry says `"unknown"`. */
+export declare function commandSeconds(name: string, args: Readonly<Record<string, string | number | boolean>> | undefined, robot: Robot): number | null;
+/** True when the registry marks this command as one the robot stands still for. */
+export declare const isStationary: (robot: Robot, name: string) => boolean;
+/**
+ * Per-step `{nominalS, lowS, highS, strafeFraction, strafeCostS, unknown}` and the total with its
+ * band, from the model of `03` section 3. Deterministic and pure.
+ */
+export declare function estimate(plan: Plan, robot: Robot): Estimate;
+/**
+ * Which way an estimate's total is a bound, when it is one. A step with no predictable duration
+ * counts as zero seconds, so the routine takes at least the total ("lower"). A step that ends on a
+ * condition is timed as if it drove its whole path, so the routine takes at most the total
+ * ("upper"). When both kinds are present the total is only a lower bound on the known part, and
+ * "lower" is reported because it is the claim that stays true. The renderer, the editor and the
+ * pull-request body all read this one rule.
+ */
+export declare function totalBound(estimateResult: Estimate): "lower" | "upper" | null;
+export {};
+//# sourceMappingURL=estimate.d.ts.map

package/dist/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../src/estimate.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,KAAK,EAEX,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAA0B,MAAM,YAAY,CAAC;AAgBzE,4DAA4D;AAC5D,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oGAAoG;IACpG,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAiDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,MAAM,EAAE,WAAW,EACnB,mBAAmB,EAAE,MAAM,EAC3B,kBAAkB,EAAE,MAAM,GACzB,UAAU,CAmEZ;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,EACrE,KAAK,EAAE,KAAK,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBxB;AAiBD,0FAA0F;AAC1F,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,EACrE,KAAK,EAAE,KAAK,GACX,MAAM,GAAG,IAAI,CAYf;AAED,mFAAmF;AACnF,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,MAAM,MAAM,KAAG,OACoB,CAAC;AAM/E;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,QAAQ,CAiQ3D;AAkDD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAI7E"}