Version Packages

[viam-ci-org-reader]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@viamrobotics/motion-tools@1.37.0

Minor Changes

• f563895: Toggle independent arm position widgets with per-arm switches
• 04f4e2e: Motion plan replayer + docs
• 2c86fdd: Dedicated edit mode

Patch Changes

• 339cb67: Refactor frame editing for plugin extraction
• 76b5ae0: Migrate camera and arm position widgets to use FloatingPanel
• f563895: Add individual switches for arm widgets, similar to cameras
• fec460a: Fix tweakpane styling race condition
• 27b41ec: Add the motion plan JSON parser (parsePlan) for the Motion Plan Replayer: validates and normalizes plan JSON into a ParsedPlan (frames, parents, trajectory, goals).
• 2da1274: Add frame-descriptor derivation for the Motion Plan Replayer: converts a ParsedPlan into static and jointed FrameDescriptors (geometry, orientation conversion, joint-index mapping, end-effector reparenting).
• 0f42c63: Add per-step snapshot generation (parsedPlanToSnapshots) and the PartOfPlan ECS relation for the Motion Plan Replayer, turning frame descriptors into renderable snapshots grouped under a plan entity.
• 7292c08: Add the Motion Plan Replayer plugin shell: a dashboard-mounted floating panel that uploads plan JSON files, parses them into snapshots, and lists them with ready/error/no-trajectory status. Exposes an extraSource snippet receiving addPlan so an embedding app can inject its own plan source (e.g. a DB picker) without escaping the plugin's context.
• ddfa766: Render Motion Plan Replayer plans in 3D and add the timeline scrubber. Selecting a plan spawns its snapshot entities under a plan entity, and a bottom scrubber (play/pause, step, seek) resolves each slider position to the corresponding snapshot via reconcileSnapshotEntities. Plan entities are tinted and torn down as a group through the PartOfPlan relation.
• a388301: Add persistent per-frame display config to the Motion Plan Replayer. Per-frame color, opacity, visibility, and axes edits made via the scene Details panel and tree now persist across scrubbing instead of being reset each step. Also fixes the Details panel "show axes helper" toggle, which previously had no effect because the batched axes renderer never reacted to the trait being added or removed at runtime.
• 3f4bd3b: Render mesh geometry in the Motion Plan Replayer.

[claude]

Docs review: No guide updates needed for this release.

The only changelog entry — #837 "Fix tweakpane styling race condition" — is an internal fix moving ThemeUtils.setGlobalDefaultTheme from onMount into component setup in App.svelte. It changes no public API, prop, or documented behavior, and no use-case guide references tweakpane theming. Verdict: (D) NO CHANGE.

[claude]

Docs review: no guide changes needed. The only changelog entry (1.36.3 — "Fix tweakpane styling race condition", #837) is an internal bug fix in App.svelte (moves ThemeUtils.setGlobalDefaultTheme from onMount into component setup so panes paint with the correct theme). No public API, prop, or documented behavior changed, so the embedding, local-usage, worldstatestore, and v1→v2 guides remain accurate. Verdict: (D) NO CHANGE.

[claude]

Docs-impact review: the only changelog entry is 1.36.3 — "Fix tweakpane styling race condition" (#837), an internal fix moving ThemeUtils.setGlobalDefaultTheme from onMount into component setup in App.svelte. No public API, prop, or documented behavior changes. Verdict: (D) NO CHANGE — no guide or migration updates needed.

[claude]

Docs review (v1.36.3): no guide changes needed.

Both changelog entries are internal-only and touch no surface documented in guides/** or migration/v1-to-v2.mdx:

• Refactor frame editing for plugin extraction #846 — Refactor frame editing for plugin extraction. Internal rewiring of src/lib/ frame-editing infra (new FrameEditor; removal of FrameEditSession/useFrameEditSession/FrameConfigUpdater; useFrames cleanup). No public API, prop, or documented-behavior change. Verdict: (D) no change.
• Fix tweakpane styling race condition #837 — Fix tweakpane styling race condition. CSS/styling bug fix in App.svelte. No public surface affected. Verdict: (D) no change.

[claude]

Docs review — no guide changes needed.

All entries in this release are internal refactors, a bug fix, and a new overlay-widget feature that no current guide references. None touch the documented public surface (<Visualizer /> props, <Snapshot />, /lib exports, or the Go draw / client/api packages).

PR	summary	verdict
#855	Per-arm switches for arm position widgets (openArmWidgets setting; ArmPositions gains an internal name prop) — overlay UI only, not in any guide	(D) no change
#846	Refactor frame editing into FrameEditor for plugin extraction — internal only	(D) no change
#851	Migrate Camera / ArmPositions widgets to the shared FloatingPanel UX — internal UI	(D) no change
#837	Fix tweakpane styling race condition — bug fix	(D) no change

[claude]

Docs review (v1.37.0): no guide updates needed — every changelog entry is internal/UI-only and none touch a documented API surface.

• Unify widget ux #855, fix: migrate camera and arm widgets to FloatingPanel UX (#849) #851, Fix tweakpane styling race condition #837 — arm-widget switches, FloatingPanel migration, tweakpane race fix: all in-app widget UI, not referenced in any guide.
• Refactor frame editing for plugin extraction #846 — internal frame-editing refactor (no public surface).
• [APP-16367] Dedicated edit mode #853 (dedicated edit mode) — removes the dashboard snippet prop and adds a new WorkspacePortal export, but neither is documented; the embedding guide's documented <Visualizer /> props (partID, cameraPose, children) are unchanged.

No draw/client/api (Go) changes, so the migration, worldstatestore, and local-usage guides are unaffected.

[claude]

Docs impact review — no guide changes needed.

All entries in this release are internal UI/UX changes, refactors, a bug fix, or a net-new surface not referenced in any current guide (embedding, local-usage, worldstatestore, v1→v2 migration), so none affect documented API surface:

• Unify widget ux #855 (per-arm widget switches) — in-app UI, not documented → no change
• [APP-16367] Dedicated edit mode #853 (dedicated edit mode) — in-app UI mode; adds a new WorkspacePortal export but does not alter documented <Visualizer /> props or /lib exports → no change
• Refactor frame editing for plugin extraction #846 (frame-editing refactor for plugin extraction) — internal → no change
• fix: migrate camera and arm widgets to FloatingPanel UX (#849) #851 (camera/arm widgets → FloatingPanel) — widget UX, not documented → no change
• Fix tweakpane styling race condition #837 (tweakpane styling race condition) — bug fix → no change
• Add motion plan JSON parser (parsePlan) #838 (parsePlan for the Motion Plan Replayer) — net-new surface, not referenced in any current guide → no change (net-new features aren't documented in this pass)

[claude]

Docs review (v1.37.0): No guide changes needed.

All seven changelog entries are internal to the visualizer app or net-new surfaces not referenced in the current guides (embedding, local-usage, worldstatestore, v1-to-v2):

• #855, #853, #851, #846, #837 — widget UX / build-edit mode / FloatingPanel migration / frame-editing refactor / tweakpane styling fix. The public Visualizer export and its documented props (partID, cameraPose, children) are unchanged (#853 only adds a WorkspacePortal export).
• #838 (parsePlan/ParsedPlan) and #839 (FrameDescriptor derivation) — net-new Motion Plan Replayer surfaces, not documented in any current guide (Replayer docs are tracked separately in #844).

[claude]

Docs review (motion-tools 1.37.0): no guide changes needed.

Reviewed all 8 changelog entries against the use-case guides (embedding, local-usage, worldstatestore, v1-to-v2). Every entry is (D) NO CHANGE — none touch a documented API surface (the draw/client/api Go packages, <Visualizer /> props, the <Snapshot />/<AxesHelper /> exports, or WorldStateStoreService):

Commit	PR	Summary	Verdict
f563895	#855	Per-arm position widget switches (runtime UI: ArmPositions.svelte, settings)	(D)
2c86fdd	#853	Dedicated edit mode (UI; adds additive WorkspacePortal export, not documented)	(D)
339cb67	#846	Frame-editing refactor for plugin extraction (internal)	(D)
76b5ae0	#851	Migrate camera/arm widgets to FloatingPanel (runtime UI)	(D)
fec460a	#837	Fix tweakpane styling race condition (bug fix)	(D)
27b41ec	#838	parsePlan JSON parser — new Motion Plan Replayer surface	(D)
2da1274	#839	Frame-descriptor derivation — new Motion Plan Replayer surface	(D)
0f42c63	#840	Per-step snapshots + PartOfPlan relation — new Motion Plan Replayer surface	(D)

The Motion Plan Replayer entries (#838/#839/#840) are net-new plugin surfaces not referenced in any current guide, so they are out of scope for this pass (documented separately). The widget/edit-mode changes are runtime UI, not documented props.

Note: the changelog line for 76b5ae0 references #849, which does not resolve via the GitHub API — the actual squashed PR is #851, which is what I reviewed.

[claude]

Docs impact review — @viamrobotics/motion-tools@1.37.0

No use-case guide changes needed. Every changelog entry is an internal UI change, a refactor, or a net-new feature that no current guide references. Verdicts below:

PR	summary	verdict
#855	Per-arm position widget switches (unify widget UX)	(D) no change
#853	Dedicated build/monitor (edit) mode	(D) no change
#846	Refactor frame editing for plugin extraction	(D) no change
#849 / #851	Migrate camera & arm widgets to FloatingPanel	(D) no change
#837	Fix tweakpane styling race condition	(D) no change
#838	Motion Plan Replayer: parsePlan JSON parser	(D) no change
#839	Motion Plan Replayer: frame-descriptor derivation	(D) no change
#840	Motion Plan Replayer: per-step snapshots + PartOfPlan relation	(D) no change
#841	Motion Plan Replayer plugin shell (panel + upload + extraSource)	(D) no change

Why no guide edits:

• The widget/edit-mode/FloatingPanel/tweakpane changes (Unify widget ux #855, [APP-16367] Dedicated edit mode #853, Refactor frame editing for plugin extraction #846, Component widgets like camera and arm widget not using current panel UX #849/fix: migrate camera and arm widgets to FloatingPanel UX (#849) #851, Fix tweakpane styling race condition #837) are in-app UI behavior. None of the four guides (embedding, local-usage, worldstatestore, v1-to-v2) document arm/camera widgets, edit/monitor mode, or the frame-editing internals. The documented <Visualizer /> props (partID, cameraPose, children) and the client/api / draw / WorldStateStoreService surfaces are unchanged.
• The Motion Plan Replayer entries (Add motion plan JSON parser (parsePlan) #838–Add Motion Plan Replayer plugin shell (panel + upload + extraSource) #841) are a net-new feature. Per the review scope, net-new surfaces (including the new extraSource snippet and parsePlan) are not documented in this version pass.

No breaking changes for existing v2 users, and no dependency bumps that alter public behavior.

[claude]

Docs check: no guide updates needed. All entries in this release are net-new features or internal changes that don't touch any documented surface. The Motion Plan Replayer work (parsePlan, frame descriptors, parsedPlanToSnapshots/PartOfPlan, the plugin shell + extraSource, and 3D rendering/scrubber) is a brand-new plugin under src/lib/plugins/ that isn't referenced in any current guide (net-new features aren't documented in this pass → (D)). The arm/camera widget switches, dedicated edit mode, FloatingPanel migration, frame-editing refactor, and tweakpane race fix are UI/internal changes — the documented <Visualizer /> props (partID, cameraPose, children) are all still present and unchanged, and no client/api, draw, or WorldStateStore signature in the guides was renamed, removed, or given a new required parameter. No changes to embedding.mdx, local-usage.mdx, worldstatestore.mdx, or v1-to-v2.mdx.

[claude]

Docs impact review — v1.37.0

Reviewed all 11 changelog entries against the current guides (embedding, local-usage, worldstatestore, migration/v1-to-v2). No guide changes needed — every entry is internal UI, a refactor, a styling fix, or a net-new feature not referenced in any current guide.

PR	Summary	Verdict
#855	Per-arm switches for arm position widgets	(D) internal widget UI
#853	Dedicated edit mode	(D) internal UI
#846	Refactor frame editing for plugin extraction	(D) internal refactor
#849/#851	Migrate camera/arm widgets to FloatingPanel	(D) internal UI
#837	Fix tweakpane styling race condition	(D) bug fix
#838	parsePlan motion-plan JSON parser	(D) net-new Motion Plan Replayer
#839	Frame-descriptor derivation	(D) net-new Motion Plan Replayer
#840	Per-step snapshots + PartOfPlan relation	(D) net-new Motion Plan Replayer
#841	Motion Plan Replayer plugin shell (extraSource)	(D) net-new plugin
#842	3D render + timeline scrubber	(D) net-new Motion Plan Replayer
(per-frame config)	Persistent per-frame display config + axes-toggle fix	(D) net-new Motion Plan Replayer + UI bug fix

Notes:

• The documented <Visualizer /> props (partID, cameraPose, children), <Snapshot />, <AxesHelper />, and the Go draw / client/api surface are unchanged by this release.
• The Motion Plan Replayer (incl. the extraSource snippet) is a net-new feature not covered by any current guide, so per the review policy it is not documented in this pass.
• New /lib exports (WorkspacePortal) and the new plugin export are net-new surfaces, also out of scope for this pass.

[claude]

Docs impact review — no guide changes needed.

All v1.37.0 changelog entries are net-new features (the Motion Plan Replayer plugin, which ships its own docs), in-app UI work (per-arm widget switches, dedicated edit mode, camera/arm FloatingPanel migration), an internal refactor (frame editing → plugin extraction), or bug fixes (tweakpane styling race; the Details "show axes helper" toggle, which just makes the in-app control match the already-documented ShowAxesHelper behavior). None alter a documented surface in embedding.mdx, local-usage.mdx, worldstatestore.mdx, or migration/v1-to-v2.mdx (<Visualizer /> props, <Snapshot />, client/api, or the draw API). Verdict: (D) no change for every entry.

(Changelog entries reference commit hashes, not #NNN PRs, so no cross-PR fetch was required.)

[claude]

Docs review (use-case guides + v1 to v2 migration): all entries in the 1.37.0 changelog classify as (D) NO CHANGE, so no guide edits are needed.

The release is dominated by the new Motion Plan Replayer plugin (parsePlan, frame-descriptor derivation, parsedPlanToSnapshots / PartOfPlan, the plugin shell plus extraSource, 3D render plus timeline scrubber, persistent per-frame display config, and mesh-geometry rendering). That is a net-new surface documented under plugins/motion-plan-replayer.mdx, which is outside this pass scope (guides/** and migration/v1-to-v2.mdx only; net-new features are not documented in this pass). The remaining entries — per-arm position-widget switches, the FloatingPanel migration for camera/arm widgets, the dedicated edit mode, the frame-editing refactor for plugin extraction, and the tweakpane styling / Details-panel show-axes bug fixes — are UI/internal changes.

None of them alter the Visualizer props, client/api, draw, or WorldStateStoreService surfaces that embedding.mdx, local-usage.mdx, worldstatestore.mdx, and migration/v1-to-v2.mdx document, and none add a new required parameter. Those guides remain accurate as written.