Add motion plan JSON parser (parsePlan)

[Marcus (sucrammal)]

The Motion Plan Replayer needs raw plan JSON turned into a typed, validated structure before anything can be rendered. Adds parsePlan, which parses a plan's concatenated JSON objects into a ParsedPlan (frames, parents, trajectory, goals) with zod validation and a typed PlanParseError.

Changes

• Frontend: Adds parse-plan.ts — zod schemas + brace-matching splitter for multi-object plan JSON; exports parsePlan, ParsedPlan, RawFrame, PlanParseError
• Tests: Adds parse-plan.spec.ts covering valid plans, malformed JSON, and missing fields

Stack

• PR Add motion plan JSON parser (parsePlan) #838
• PR Add frame-descriptor derivation for motion plans #839
• PR Add per-step snapshots and PartOfPlan relation for motion plans #840
• PR Add Motion Plan Replayer plugin shell (panel + upload + extraSource) #841
• PR ScrubbingUI to visualize parsed motion plan JSON #842
• PR Persist per-frame display config + fix axes-helper toggle #843

Links

APP-9316

Testing

• Run npx vitest run src/lib/plugins/MotionPlanReplayer/tests/parse-plan.spec.ts
• Confirm valid multi-object plan JSON parses into a ParsedPlan; malformed input throws PlanParseError with a readable message

---

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[changeset-bot]

🦋 Changeset detected

Latest commit: 29ca7cc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@viamrobotics/motion-tools	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://viamrobotics.github.io/visualization/pr-preview/pr-838/
Built to branch gh-pages at 2026-07-10 18:55 UTC. Preview will be ready when the GitHub Pages deployment is complete.